問題タブ [aglio]
For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.
node.js - aglio API blueprint render インストール エラー
aglio https://github.com/danielgtaylor/aglioをインストールしようとしていますが、エラーが発生したために先に進むことができません。
私のサーバーはcento OS 6.5です。
ここで説明されているように、ノード js をインストールしましたhttps://www.digitalocean.com/community/tutorials/how-to-install-and-run-a-node-js-app-on-centos-6-4-64bit
そして、コーヒースクリプト1.8.0が見つからないため、別のエラーが表示されました。私はそれをインストールしましたnpm install -g coffee-script
このエラーを取り除く方法を教えてください。
これは、エラーに関する完全な情報です。
apiblueprint - API ブループリント + Aglio でのデータ抽象化?
API ブループリントの仕様を読むと、次のように「データ構造」を指定できるように設定されているようです。
- 住所
- 通り: 100 Main Str. (文字列) - 番地
- zip: 77777-7777 (文字列) - zip / 郵便番号
...
- お客様：
- ハンドル: mrchirpy (文字列)
- 住所: (住所)
次に、モデルで、データ構造への参照を作成します。
モデル
[お客様][]
データ構造を参照することにより、エンドポイントに沿ってドキュメントと例を生成する必要があるようにすべて設定されているようです。
ただし、それを機能させることはできないようです。また、「完全に正規化されたデータ抽象化」を使用した例を見つけることもできません。データ構造を一度定義してから、どこでも参照したいと考えています。ツールに問題があるようです。具体的には、レンダリング エージェントとしてaglioを使用しています。
これはすべて折り畳みタイプのもののトップになるように思われるので、私は混乱しており、何かが欠けているのか、ここで何が可能かについて間違った仮定をしているのか疑問に思っています.
rest - Aglio では、ボディ内のパラメーターをパラメーターとして定義することはできません
API ブループリント レンダラーである Aglio では、リクエストの本文のパラメーターをエンドポイント仕様のパラメーター セクションに含めることはできません。次のように解析警告をスローします。
parameter '<some_parameter>' not specified in '<some_description>' its '<some_URI_template>' URI template (warning code 8)
この警告を再現する Markdown の例は次のとおりです。
URI テンプレートに含まれていないため、レンダリングされた 'destination' がパラメーターになることは好まれません。
私の質問は、これはツールの欠点ですか、それとも API ブループリントの仕様ですか? また、おそらく、この REST エンドポイントの定義は標準に準拠していないのでしょうか?
apiblueprint - API ブループリント / MSON でパターンを使用する
API ブループリント、特に MSON の新しいデータ構造構文の可能性を調査しています。パターン（正規表現）のようなものを添付または指定することは可能ですか？このトピックについては何も見つかりませんでした。
apiblueprint - Stripe のエラー「属性」のような結果をもたらす ApiBlueprints パラメータ?
私は Stripe を初めて使用し、エラー部分の「属性」部分のような結果を生成したいと考えています: https://stripe.com/docs/api/curl#errors
テーブルではないのに、2 列のテーブルのように見えます。
どうやってこれを作ることができるのかわかりません。
参考までに、Aglio を使用してテンプレートを生成しています。
data-structures - API ブループリントのデータ構造としてのプリミティブ型
データ構造の記述にプリミティブ型を使用したい。そのようです：
そして、出力は次のとおりです。
なので説明不足。私は別の場所に説明を入れようとしました。私はたくさんのことをしました（それらについては話したくありません）。また、次のように列挙値に情報を追加しようとしました:
この問題が MSON 構文と Aglio ジェネレーターのどちらを扱っているかはわかりません。
apiblueprint - リクエスト/レスポンスの本文とデータ構造を混在させる
aglio/api ブループリントを使用して、新しい API の優れたドキュメントを作成したいと考えています。
JSON は非常に大きくなる可能性があるため (多数のオプション値を含む)、本文で適切な使用例を示したいと思いますが、json スキーマのデータ構造も使用します。ただし、スキーマが本文に正確に適合する場合は常に、結果の HTML が「Hello, world!」をスローします。これは、例のデータを入力していないためです。ただし、本文には完全で有効な例があるため、 aglio が Hello World の出力を作成するとは思っていませんでした。
参考までに、結果の htmls 本文に表示されると予想されるのは次のとおりです。
実際に表示されるのは次のとおりです。
これが未加工の API の設計図です。
まず、それは有効な方法ですか? 別のアプローチをお勧めしますか？養蜂場では意図したとおりに機能するため、これは aglio のバグですか? ありがとう！