Bitbucket REST API バージョン 1 を使用する

Bitbucket Cloud v1 API は廃止予定です

Bitbucket Cloud REST API version 1 is deprecated effective 30 June 2018, and were removed from the REST API permanently on 29 April 2019. Read the deprecation notice. Or you can jump right to the version 2.0 REST API documentation.

限られた 1.0 API リソースの一時的なサポートについて

The 2.0 REST API will rely on the Atlassian Cloud Admin API for user and group management, but those API endpoints are not yet available. Until the Atlassian platform services are fully available in Bitbucket we will continue to support these 1.0 REST endpoints:

  • /1.0/groups

  • /1.0/group-privileges

  • /1.0/invitations

  • /1.0/users/{accountname}/invitations

1.0 のレスポンス形式

Bitbucket Cloud のバージョン 1 の REST API を使用する場合、ご利用のアプリケーションが HTTP リクエストを作成し、レスポンスをパースします。既定のレスポンス形式は JSON です。必要に応じ、「?format=」クエリ文字列パラメーターを使用してこの挙動をオーバーライドし、XML または YAML 形式で受け取ることができます。たとえば、次のクエリ文字列を利用して出力を YAML 形式で受け取ることができます。

?format=yaml

また、'?callback=' クエリ文字列パラメータと関数名を指定することで、レスポンスを JSONP 経由で受け取ることができます。例:

?callback=myJSfunc

Bitbucket Cloud のレスポンスには必ず、次のいずれかのレスポンス コードを含むレスポンス ヘッダーが含まれます。

コー​​ド

説明

200 OK

成功時に返されます。GET メソッドの場合、レスポンスにはリクエストされたリソースに対応するエンティティが含まれます。POST メソッドの場合、作成されたエンティティが含まれます。

201 CREATED

新しいリソース インスタンスが正常に作成された場合に返されます。

204 NO CONTENT

リソース インスタンスが正常に削除された場合に返されます。

400 Bad Request

不正な形式のリクエストが送信された場合に返されます。必須パラメータを設定し忘れた場合などにこの応答を受け取る可能性があります。

401 UNAUTHORIZED

呼び出しで認証が必要で、提供された資格情報の認証に失敗した場合、または資格情報が提供されていない場合に返されます。

403 FORBIDDEN

呼び出し元が、許可されていないリソースを呼び出しまたは変更しようとした場合に返されます。リクエストが有効で、呼び出し元の資格情報の認証に成功しても、呼び出し元にリソースへのアクセス権が付与されるわけではありません。

404 NOT FOUND

指定したリソースが存在しない場合に返されます。

呼び出し内容よっては、レスポンスのボディが返されない場合があります。ボディが返される場合、JSON 形式の期待される構造については個々のドキュメントをご参照ください。

タイム ゾーン

Any timestamp returned whose key contains "utc" is in Coordinated Universal Time. All other timestamps are in the local time of Amsterdam. Amsterdam timestamps are now deprecated. If you're using them in your application, please switch to the UTC equivalents.

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。
コミュニティに質問
このページの内容1.0 のレスポンス形式タイム ゾーン
コミュニティ質問、ディスカッション、記事