一般的な基準とガイドライン
このセクションでは、ALM OctaneでREST API仕様を操作するための標準とガイドラインを提供します。
標準
仕様を導く原則は、Roy Fieldingによって導入された基本的なRESTガイドラインに従います。詳細については、Representational State Transfer (REST)を参照してください。
これらは、REST overHTTPを実装するために必要なガイドラインです。これらのガイドラインは、ALM Octaneに適合しています。ただし、ガイドラインは標準に従っていることに注意してください。
ガイドライン
プラットフォームと言語 | アプリケーションは、RESTをサポートする任意の言語および任意のプラットフォームで作成できます。RESTの詳細については、Representational State Transferを参照してください。 |
データ形式 |
APIは、要求と応答の両方でアプリケーション/json表現のみをサポートします。 リソースのリファレンスで特に指定されていない限り、データはJSON形式で送信および返されます。このAPIは、ECMA 404仕様を使用します。 |
コミュニケーションとセキュリティ |
|
アプリケーションによって送信されるリクエストURIは、 URL-encodedれている必要があります。URLエンコードの詳細については、IETF: を参照してください。ユニフォームリソース識別子 (URI): 一般的な構文。 詳細については、URIsを参照してください。 |
|
ヘッダー |
データを送信するときは、常にContent-Typeヘッダーを送信して、クライアントからサーバーに送信されるデータのタイプを指定します。 Content-Typeヘッダーは、認証時を含め、application/jsonである必要があります。 コンテンツが送信されない限りContent-Typeヘッダーを送信しないでください。 サーバーから受信するデータの形式を指定するには、常にAcceptヘッダーを送信します。 詳細については、リクエストの実行を参照してください。 |
クッキーを再送する |
"Set-Cookie" ヘッダーを使用して、前の応答でサーバーから送信されたすべてのCookieを返します。http://tools.ietf.org/html/rfc6265を参照してください。Cookieの再送信に失敗すると、ユーザーがREST APIサービスを操作しているときに認証が期限切れになる可能性があります。 詳細については、セッションの管理と有効期限を参照してください。 |
時間データ |
時間データはUTC形式でデータベースに保存されます。REST APIは、UTC時刻を現地時間に変換できません。したがって、UIクライアントはUTC形式をグローバルユーザーの現地時間に変換します。 REST APIコンシューマーは、時間データでも同じことを行う必要があります。 |
次のステップ