opendev/gerrit
Code Issues Proposed changes

Move description of some account REST endpoints into the correct section

Browse Source 
The List Contributor Agreements, Sign Contributor Agreement and Index
Account REST endpoints were wrongly listed in the 'Star Endpoints'
section but they belong into the 'Account Endpoints' section.

Change-Id: I3eff7f3cd34f6e011860d786ed0844db7c5faab9
Signed-off-by: Edwin Kempin <ekempin@google.com>
This commit is contained in:
Edwin Kempin
2018-04-10 09:33:22 +02:00
parent 1a4041f0c2
commit 2e88bb8200
1 changed files with 83 additions and 83 deletions
Download Patch File Download Diff File Expand all files Collapse all files

166
Documentation/rest-api-accounts.txt
View File

@@ -1765,6 +1765,89 @@ Only external ids belonging to the caller may be deleted.
HTTP/1.1 204 No Content
----
[[list-contributor-agreements]]
=== List Contributor Agreements
--
'GET /accounts/link:#account-id[\{account-id\}]/agreements'
--
Gets a list of the user's signed contributor agreements.
.Request
----
GET /a/accounts/self/agreements HTTP/1.0
----
As response the user's signed agreements are returned as a list
of link:#contributor-agreement-info[ContributorAgreementInfo] entities.
.Response
----
HTTP/1.1 200 OK
Content-Disposition: attachment
Content-Type: application/json; charset=UTF-8
)]}'
[
{
"name": "Individual",
"description": "If you are going to be contributing code on your own, this is the one you want. You can sign this one online.",
"url": "static/cla_individual.html"
}
]
----
[[sign-contributor-agreement]]
=== Sign Contributor Agreement
--
'PUT /accounts/link:#account-id[\{account-id\}]/agreements'
--
Signs a contributor agreement.
The contributor agreement must be provided in the request body as
a link:#contributor-agreement-input[ContributorAgreementInput].
.Request
----
PUT /accounts/self/agreements HTTP/1.0
Content-Type: application/json; charset=UTF-8
{
"name": "Individual"
}
----
As response the contributor agreement name is returned.
.Response
----
HTTP/1.1 200 OK
Content-Disposition: attachment
Content-Type: application/json; charset=UTF-8
)]}'
"Individual"
----
[[index-account]]
=== Index Account
--
'POST /accounts/link:#account-id[\{account-id\}]/index'
--
Adds or updates the account in the secondary index.
.Request
----
POST /accounts/1000096/index HTTP/1.0
----
.Response
----
HTTP/1.1 204 No Content
----
[[default-star-endpoints]]
== Default Star Endpoints
@@ -1981,89 +2064,6 @@ returned. The labels are lexicographically sorted.
]
----
[[list-contributor-agreements]]
=== List Contributor Agreements
--
'GET /accounts/link:#account-id[\{account-id\}]/agreements'
--
Gets a list of the user's signed contributor agreements.
.Request
----
GET /a/accounts/self/agreements HTTP/1.0
----
As response the user's signed agreements are returned as a list
of link:#contributor-agreement-info[ContributorAgreementInfo] entities.
.Response
----
HTTP/1.1 200 OK
Content-Disposition: attachment
Content-Type: application/json; charset=UTF-8
)]}'
[
{
"name": "Individual",
"description": "If you are going to be contributing code on your own, this is the one you want. You can sign this one online.",
"url": "static/cla_individual.html"
}
]
----
[[sign-contributor-agreement]]
=== Sign Contributor Agreement
--
'PUT /accounts/link:#account-id[\{account-id\}]/agreements'
--
Signs a contributor agreement.
The contributor agreement must be provided in the request body as
a link:#contributor-agreement-input[ContributorAgreementInput].
.Request
----
PUT /accounts/self/agreements HTTP/1.0
Content-Type: application/json; charset=UTF-8
{
"name": "Individual"
}
----
As response the contributor agreement name is returned.
.Response
----
HTTP/1.1 200 OK
Content-Disposition: attachment
Content-Type: application/json; charset=UTF-8
)]}'
"Individual"
----
[[index-account]]
=== Index Account
--
'POST /accounts/link:#account-id[\{account-id\}]/index'
--
Adds or updates the account in the secondary index.
.Request
----
POST /accounts/1000096/index HTTP/1.0
----
.Response
----
HTTP/1.1 204 No Content
----
[[ids]]
== IDs