問題タブ [raml]

Raml 1.0 への raml2html のバージョンがあるかどうか誰かが知っていますか? raml2htmlや raml2mdなど、Raml 0.8 用のツールしか見つかりませんでしたが、Raml 1.0 では機能しません。

カスタム オブジェクトを json スキーマ ファイルとして定義し、関連するサンプルを別のファイルとして定義したいと考えています。私はこのようなことをしたい:

しかし、「type:」ステートメントで始まる行に次のエラー メッセージが表示されます - 「エラー: 異なる種類の両方の型から継承することはできません」

仕様ではそれは言う

外部型は、型の継承または特殊化に参加できません。つまり、新しいプロパティを宣言したり、ファセットを設定したりする外部型のサブタイプを定義することはできません。ただし、メタデータ、例、および説明を追加する単純なタイプのラッパーを作成できます。

これが問題だと思います。しかし、「型ラッパー」を作成することの意味がわかりません。誰かが私が望むものを達成するための最良の方法を教えてもらえますか.

このツールを使用して API を定義し、.NET で Web API コードをスキャフォールド アウトしたところです。https://visualstudiogallery.msdn.microsoft.com/cadcb820-762c-4514-9817-884b7558aaa9 ソリューションに一連のコントローラーとコントラクトを作成する RAML コントラクトを追加しました。メタデータ出力を有効にする関数も実行しました。/raml ページに移動すると、素晴らしい API 仕様が表示されます。ただし、すべてのバージョンが 2 つあるため、それを防ぐために何を変更すればよいかわかりません。たとえば、私の .raml ファイルには、"operators" というリソースがあります。ツールを使用して、「OperatorsController」と呼ばれるコントローラーを作成します。.raml 定義ファイルの baseUri はhttp://localhost:51366/api/ です。WebApiConfig.Register 関数の MapHttpRoute は、api/{controller}/{id} の routeTemplate で設定されます。/raml ページには、/bookings のエントリと /api/Bookings のエントリがあります。最初のものは .raml 仕様に由来し、2 番目は作成された BookingsController に由来するようです。

重複を防ぐ方法を教えてください.APIの作成をいじったのは初めてなので、ここで明らかな何かが欠けている可能性があります...

RAML を使用して Web サービス API を作成しています。

2 つのセキュリティ スキームを使用して RAML を作成しました

• OAuth 2.0
• カスタム

私の最初のアプローチは、リクエスト内で特別なパラメーターを送信し、承認タスクをいずれかの承認エンジンに委任するリクエストパラメーターに基づいて承認を処理することでした。しかし、OAuthサーバーにリクエストが行われたときに、それがスローされましたNull Pointer Exception。
次に、異なる認証スキームの認証リクエストには異なる URI が必要であることを知りました。たとえば、oAuth のリクエストが行われた場合、URI は /api/oauth2/authorize?parameters のようになり、他のスキームの場合、oauth 1.0 は /api/oauth1/ になる可能性があります。認可?パラメータ

これを実装するために、異なる URI パターンを持つ 2 つの APIkit ルーター フローを追加しました。

添付画像の最初の APIKit フローはカスタム承認用で、2 つ目は OAuth 用です。画像からわかるように、2 番目のフローで APIkit ルーターの前に OAuth バリデーターを追加しました。

各リクエストを認証できるように、OAuthバリデーターをその場所に配置するこれが正しいアプローチであるかどうかを知りたいですか? または、リクエストが行われた後に OAuth が個々のリソースのリクエストを検証するように、OAuth バリデーターを各リソース フローの最初の要素にする必要があります。また、OAuth では、最初にリクエストが認証され、次に保護されたリソースへのアクセスが許可されることをどこかで読んだことがあります。その場合、APIKit ルーターの前に OAuth バリデーターを追加するという私のアプローチは正しいと思います。しかし、私はそれについて確信が持てず、このシナリオ全体で 2 番目のアドバイスが必要でした。

ありがとうございました。

私は、Web サービスを介してそのメソッドの一部を公開する必要があるプロジェクトに取り組んでおり、RAML に従って Mule を使用し、セキュリティを実装するために OAuth 2.0 が提案されています。「client_id」と「client_secret」についてクライアントを検証できますが、そのために、構成ファイルでのみ資格情報を指定しました。ここで、データベースからクライアントの詳細を取得する必要があります。「preFlow-ref」を使用してみましたが、「client_id」と「client_secret」を取得できる別のフローが呼び出されていますが、OAuth にコールバックを渡す方法がわかりません。

サービスへの post メソッドが json を想定していることを raml 定義で指定した場合、生成された post メソッドは、その json をカプセル化し、スキーマに準拠するオブジェクトを正しく受け取りました。

ただし、post メソッドを application/x-www-form-encoded formParameters を受け入れるように変更したわけではありません。生成された post メソッドには、各パラメーターに対応する引数が含まれていません。それを期待したのは間違っていますか？

前と作業:

これにより、署名付きの post メソッドが生成されました。

しかし、RAML を次のように変更しました。

生成された post メソッドは次のようになると予想していました。

代わりに、次のようになります。

誰かが理由を説明してもらえますか?

ありがとうございました、

ポール