invitations エンドポイント

Bitbucket Cloud v1 API は廃止予定です

Bitbucket Cloud REST API バージョン 1 は 2018 年 6 月 30 日に廃止予定となり、2019 年 4 月 29 日に REST API から完全に削除されました。廃止についての告知をご確認ください。また、バージョン 2.0 の REST API ドキュメントをご確認ください。

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

2.0 REST API では、ユーザーおよびグループ管理は Atlassian Cloud Admin API を使用して行う予定ですが、これらの API エンドポイントはまだ提供されていません。Bitbucket でアトラシアンのプラットフォーム サービスが完全に利用できるようになるまでは、次の 1.0 REST エンドポイントが引き続きサポートされます。

  • /1.0/groups

  • /1.0/group-privileges

  • /1.0/invitations

  • /1.0/users/{accountname}/invitations

概要

invitations エンドポイントを使用すると、Bitbucket Cloud リポジトリ管理者はリポジトリに対する読み取り、書き込み、または管理権限を与えるための招待メールを送信できます。ユーザーに送信されるメールには、招待を承認するための URL が含まれます。受信者がメール アドレスに対応する Bitbucket アカウントを既に持っている場合、リポジトリにアクセスするにはそのアカウントにログインする必要があります。ユーザーが Bitbucket アカウントを持っていない場合、ユーザーはリポジトリにアクセスする前に Bitbucket アカウントを作成する必要があります。invitation エンドポイントには次のフィールドがあります。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 "sent_on": "2011-01-11 01:03:31", "permission": "write", "invited_by": { "display_name": "Roger", "account_id": "557058:ec25fab6-5844-4b65-a30c-677ecd2ce3b5", "is_team": false, "avatar": "https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/CS-5.png", "resource_uri": "/api/1.0/users/roger", "nickname": "roger", "uuid": "{746046c8-9d5a-4b86-a414-485452396952}" }, "repository": { "website": "", "read_only": false, "has_wiki": true, "last_updated": "2010-12-24 05:26:20", "name": "ramjet", "language": "", "deleted": false, "is_mq": false, "mq_of": null, "created_on": "2010-12-24 05:26:20", "fork_of": null, "email_writers": true, "size": 4096, "owner": "roger", "has_issues": true, "no_public_forks": false, "email_mailinglist": "", "is_fork": false, "slug": "ramjet", "is_private": true, "description": "" }, "email": "john@example.com" }

これらのフィールドは次のとおりです。

フィールド

説明

sent_on

ユーザーが招待された 1 つ以上のアカウント グループ。

permission

リポジトリに付与された権限。次のいずれかです。

  • read

  • write

  • admin

invited by

招待元ユーザーのユーザー プロファイル。

repository

ユーザーが招待されたリポジトリ。

email

招待の外部メール

POST による招待の送信

1 POST https://api.bitbucket.org/1.0/invitations/{accountname}/{repo_slug} --data 'permission={permission}' --data 'email={email_address}'

ユーザーをリポジトリに招待します。このメソッドでは次のパラメーターを使用できます。

パラメーター

必須かどうか

説明

accountname

はい

チームまたは個人のアカウント。

repo_slug

はい

そのアカウントに所属しているリポジトリ。

email_address

はい

メール受信者

permission

はい

受信者に付与される権限

john@example.com にリポジトリ roger/ramjet への書き込み権限を付与する招待を送信するには、次のようにします。

1 $ curl --user roger:password --request POST https://api.bitbucket.org/1.0/invitations/roger/ramjet --data permission=write --data email=john@example.com

応答は次のようになります。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 { "sent_on": "2011-01-11 01:03:31", "permission": "write", "invited_by": { "display_name": "Roger", "account_id": "557058:ec25fab6-5844-4b65-a30c-677ecd2ce3b5", "is_team": false, "avatar": "https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/CS-5.png", "resource_uri": "/api/1.0/users/roger", "nickname": "roger", "uuid": "{746046c8-9d5a-4b86-a414-485452396952}" }, "repository": { "website": "", "read_only": false, "has_wiki": true, "last_updated": "2010-12-24 05:26:20", "name": "ramjet", "language": "", "deleted": false, "is_mq": false, "mq_of": null, "created_on": "2010-12-24 05:26:20", "fork_of": null, "email_writers": true, "size": 4096, "owner": "roger", "has_issues": true, "no_public_forks": false, "email_mailinglist": "", "is_fork": false, "slug": "ramjet", "is_private": true, "description": "" }, "email": "john@example.com" }

その他のヘルプ