問題タブ [raml]

OAuth2 を使った API を RAML で記述したい

自分の API の RAML と比較するために使用できるソリューションや例はありますか?

DELETE 操作中にリクエスト本文を取得するにはどうすればよいですか? Mule メッセージ ペイロードは、クライアントから送信された JSON ドキュメントではなく URI です。

少し背景

RAML で POST、PUT、および DELETE 操作を定義し、APIKit を使用して Mule プロジェクトを生成しました。REST Web サービスの呼び出し元には主キーがないため、URI に配置することはできません (これが DELETE の使用方法であると想定しています)。ただし、クライアントには、サービス層が主キーを検索してデータベース内のレコードを削除するために使用する 2 つのデータがあります。

DELETE 操作用に 2 つのクエリ パラメーターを作成するだけでよいと思いますが、本体で JSON ドキュメントを渡すだけの方がよいでしょう。

OAuth と複数のリビジョンの可能性と共に複数のクライアントで使用される Web サービスのバックエンドを構築するためのドキュメント ツールを検討してきました。私はすでに養蜂場について知っていましたが、少し調査を行ったところ、収益性の高い他のかなり優れたソリューションが見つかりました.

RAML は、優れたコード生成と API の再利用性を約束しているようです。しかし、モックサーバーを作成することはできないようです。また、apiblueprint を使用して REST API のクライアント側ライブラリとサーバー側スケルトンを生成できない理由がわかりません。

私たちにとって最良のユースケースは、コードを書くためのスケルトンを提供するノードエクスプレス/レスティファイアプリとともに、サービスを利用するためのクライアント iOS/Android/wp/js ライブラリを自動生成できる API のドキュメントです。API テストと負荷テストに加えて。

RAML/Swagger/Apiary のどのソリューションがこれに最適ですか?

私はさまざまなサービスで Angular の $http モジュールをかなり多く使用してきましたが、それを Mulesofts RAML パーサーと統合したいと考えていました。これにより、RAML 仕様に適合するために角度の一部を更新する必要がないという利点が得られます。

誰かがこれをしましたか？必要な手順は何ですか?

これが不可能な場合は、RAML で説明されている REST リソースに $resource モジュールを使用するだけで十分だと思います。

RAML のすべてのチュートリアルに目を通そうとしましたが、とても興奮しました。

ほとんどのオンライン リソースが利用可能であることがわかりましたが、その理由がわかりませんでした。すべてをセットアップしてフローが生成されると、それをミュール アプリケーションとしてローカルで実行し、localhost:8081/api/console/ をポイントすると、 huuuuuuuge json レスポンスですが、ここで例として説明されている UI ではありません。

私は RAML で API 仕様を書いていますが、動的な MIME タイプを作成するために uri パラメータを参照できるかどうか疑問に思っていました。の線に沿った何か

API デザイナーで RAML を書いていますが、次のコードがあります。

パーサーは、メソッド/{slug}のプロパティとして使用しようとしていると考えているため、エラーをスローしています。get:ただし、/{slug}下位にするにはインデントする必要があります/tags。

RAML (または RAML は YAML のインスタンスであると想定されているため、YAML) でマップの終わりをマークする方法はありますか? または、他に何か提案はありますか？

RAML と API Manager を使用して Mule プロジェクトを操作していました。ここに記載されている手順に従って

API Manager を使用して、次のような特性に関連付けられたサービスを処理する AM

• シンプルなセキュリティ マネージャー、
• OAuth 2.0 プロバイダーと
• OAuth 2.0 アクセス トークンの適用。

次のリダイレクトを行う別のフローがあります

1. 「ステータス」を 302 に設定します

2. 「場所」を以下の URL に設定します

   http://localhost:8081/org/oauth/token?grant_type=authorization_code&&client_id=53a406c3e4b0624da8246eed&client_secret=myclientsecret&code=#[message.inboundProperties.code]&redirect_uri=http://localhost:8081/raml-api-with-oauth/redirect

ここまでは順調です。

しかし、アクセス トークンの URL にアクセスしようとすると、メッセージが表示されます。

{"error":"unauthorized_client","error_description":""}

私の質問を要約するには：

1. 「OAuthダンス」手順を手伝ってください
2. API との有効なコントラクトを設定して、OAuth ダンスに必要な clientId と clientSecret の通信を容易にする方法を教えてください。

どこが間違っているのか教えてください。

RAML コード: