問題タブ [raml]

タイトルが少しわかりにくいかもしれないので、私が達成しようとしていることは次のとおりです。

どちらも POST 呼び出しである RAML を使用して、token_grant メソッドと token_refresh メソッドを文書化する必要があります。

token_grant : 初めて OAuth トークンを生成する token_refresh : アクセス トークンを更新する

それらはクエリ パラメータが異なり、もちろん返される結果も異なります。問題は、それらが両方とも同じリソースの下にあり、RAML が各リソースに対して 1 つの POST 呼び出ししか許可しないことです。

ポストコールを 1 回に制限して、これを回避する方法はありますか? たぶん、クエリパラメータに応じて条件付きのものを持っているのでしょうか?

token_grantのテンプレートは次のとおりです。

token_refreshのテンプレートは次のとおりです。

したがって、主な問題は、これらを下にまとめる方法です

どんな助けでも大歓迎です どうもありがとう！

I try to validate linkedin.raml but I got below set of validation errors for some reason.

Below is the code snippet I used to validate RAML

Is this expected? if not what is causing this? for more reference kindly find set of mvn dependancies I have used in my orbit bundle.

Apparently in the linkedin.raml at line number :178 causing this issue. Why is this?

Node と Express を使用して REST API を構築しようと考えており、ドキュメントを提供したいと考えています。これを手作業で作成したくありません。Swagger、RAML、および Api Blueprint/Apiary の形式で利用できるソリューションがあるようです。

私が本当に望んでいるのは、Swashbuckle または Microsoft が提供するソリューションを使用して .NET ランドで可能なように、API コードからドキュメントを自動生成することですが、強力な型付けとリフレクションによって可能になります。

JS の世界では、Swagger/RAML/Api Blueprint マークアップを使用して API を定義し、ドキュメントを生成して、そこからサーバーを足場にするのが正しいオプションのようです。前者は簡単に思えますが、後者についてはよくわかりません。これらすべてのオプションのサーバー コード生成について私が見たものは、非常に限られているようです。定義を簡単に更新できるように、自動生成されたコードを手動コードから分離する何らかの方法が必要ですが、それに関する兆候や議論は見たことがありません。それは克服できない問題のようには見えません (私は JS よりも .NET に精通しているので、簡単に何かを見落としている可能性があります)。一年前。

何かが欠けている/誤解されているかどうか、および上記の問題の解決策が存在するかどうかを誰かに教えてもらえますか?

私は現在、このチュートリアルに従っています: https://docs.mulesoft.com/anypoint-platform-for-apis/creating-an-apikit-project-with-mavenしかし、わからない RAML ファイルの作成に問題がありますこれを行う方法と、次の 2 つの API から情報を取得する必要があります
。

使用する必要があるのはスキーマですか? 最終的な目標は、都市と国に関する情報を提供する API を作成することです。そのためには、他の API プロバイダー (上記の 2 つのリンク) と通信して情報を取得し、必要な情報を返す JSON 応答を作成する必要があります。

RAML ドキュメント (v 1.0) を作成しようとしていますが、最初の段階で継ぎ目が詰まっています。次のように定義したベンダー リソースがあります。

get リクエストでタイプに何を書くべきかわかりません (今は ??? です) API はベンダー タイプのオブジェクトの配列で応答しますが、それを RAML に正確に伝えるにはどうすればよいですか?