swagger-2.0

    7

    1答えて

    Swaggerを使用してgolangで作成されたREST APIのドキュメントを作成しようとしています。私はこのガイドに従っています:https://goswagger.io/generate/spec.htmlこれを行うには私のメインファイルで私のコメントからjsonファイルを作成することができましたが、私は実際の掃除仕様に変換する.yamlファイルを作成する方法はわかりません。私はページの指示

    2

    1答えて

    基本認証の保護されたAPIがありますが、認証資格情報を入力した後は要求ヘッダーには適用されません。私は、奇妙なエディタで "ERROR Server not found or error occurred"が見え、Fiddlerで "401 Unauthorized"が見えました。 ユーザー名およびPWD:ここではODATAとqtkr47PTM3pmzLyEHNrW4DXhhgyjMfM3CKUZ

    3

    1答えて

    私のAPIは、従来のステータスコードを尊重し、私は「私のAPI定義 404: description: The resource doesn't exist schema: $ref: '#/definitions/Error' default: description: An unexpected error has occurred

    0

    2答えて

    API情報をスワッガーUI形式で表示するWeb API URLがあります。 Web APIのURLを使ってSwagger codegenからクライアントライブラリを生成したい。 URLをhttps://editor.swagger.ioにインポートする際に、どのようにユーザー名とパスワードを渡すことができるか教えてください。私の場合、URLをインポートしているときは、このurlには認証用のユーザー

    12

    1答えて

    RESTの世界では、RESTインタフェース境界(クライアントとサーバの間の契約)を完全に記述するSwagger仕様のようなものがあります。これらのSwagger仕様は、RESTクライアントの自動生成に使用できますが、REST APIコンシューマ用のドキュメントを自動的に生成するためにも使用できます。さらに、これらのSwagger仕様は、貴重な資産です。 CIとAPIのバージョン管理。 同様のソリュ

    0

    1答えて

    APIの安定性の指標はAPIドキュメントでは重要ですが、現在私はSwashbuckleを使ってASP.NET Web APIで構築されたAPIをドキュメント化しています。 "安定"、 "凍結"などのAPI安定性指標を持つAPIにフラグを立てます。

    1

    1答えて

    私はSpring RESTアプリケーションを持っています。 APIドキュメントの目的にSwaggerを使用しています。 私は自分のRESTコントローラを持っていますが、方法は@RequestMappingです。 私は2つのオーバーロードされたメソッドを持っています。それらは引数の点で異なります。 しかし、Swagger UIには1つしか表示されません。 私のアプローチは間違っていますか(コントロー

    3

    1答えて

    を移動する方法。私は基本的なSpringApplication.run(Startup.class, args);を介してこれを起動すると、デフォルトのコンバータが上書きされますが、カスタム@Configurationクラスを持っています。私は、エンドポイントのGADSがあるので、私は社内のユーザーベースのためのより良いドキュメントを生成することができるように、物事のミックスにSwaggerを追加

    1

    1答えて

    yamlの構文を使って、swaggerでrefの配列を定義する方法について質問があります。次 - name: myfield in: formData description: 'description' required: false type: array items: $ref: '#/definitions/MyRef

    2

    2答えて

    こんにちは、私はBodyパラメーターでDefault値を送信しようとしていますが、送信中はNot takingです。誰でもこの問題について私を助けてください。ここに私のコードがあると swagger: '2.0' info: version: 1.0.0 title: PetStore on Heroku description: | **This exa