アクセストークン

MANBO API v1で認証認可を行うためのアクセストークンを表します。

client_id
- 登録されたAPIクライアントを特定するためのID
- Example:”a91f0396a0968ff593eafdd194e3d17d32c41b1da7b25e873b42e9058058cd9d”
- Type:xs:string
- Pattern:/^[0-9a-f]{40}$/
scopes
- アクセストークンに許された操作の一覧
- Type:array
token
- アクセストークンを表現する文字列
- Example:”ea5d0a593b2655e9568f144fb1826342292f5c6b7d406fda00577b8d1530d8a5″
- Type:xs:string
- Pattern:/^[0-9a-f]{40}$/

POST /api/v1/access_tokens

与えられた認証情報をもとに新しいアクセストークンを発行します。

client_id
- 登録されたAPIクライアントを特定するためのID
- Example: “a91f0396a0968ff593eafdd194e3d17d32c41b1da7b25e873b42e9058058cd9d”
- Type:string
- Pattern:/^[0-9a-f]{40}$/
client_secret
- 登録されたAPIクライアントを認証するための秘密鍵
- Example: “01fc259c31fe39e72c8ef911c3432a33d51e9337ff34c4fac86c491a0d37251f”
- Type:xs:string
- Pattern:/^[0-9a-f]{40}$/
code
- リダイレクト用のURLに付与されたアクセストークンと交換するための文字列
- Example: “fefef5f067171f247fb415e38cb0631797b82f4141dcdee66db846c3ade57a03”
- Type:string
- Pattern:/^[0-9a-f]{40}$/

POST /api/v1/access_tokens HTTP/1.1
Content-Type: application/json
Host: api.manbo.link

{
  "client_id": "a91f0396a0968ff593eafdd194e3d17d32c41b1da7b25e873b42e9058058cd9d",
  "client_secret": "01fc259c31fe39e72c8ef911c3432a33d51e9337ff34c4fac86c491a0d37251f",
  "code": "fefef5f067171f247fb415e38cb0631797b82f4141dcdee66db846c3ade57a03"
}

POST /api/v1/access_tokens HTTP/1.1

Content-Type: application/json

Host: api.manbo.link

{

"client_id": "a91f0396a0968ff593eafdd194e3d17d32c41b1da7b25e873b42e9058058cd9d",

"client_secret": "01fc259c31fe39e72c8ef911c3432a33d51e9337ff34c4fac86c491a0d37251f",

"code": "fefef5f067171f247fb415e38cb0631797b82f4141dcdee66db846c3ade57a03"

}

HTTP/1.1 201
Content-Type: application/json

{
  "client_id": "a91f0396a0968ff593eafdd194e3d17d32c41b1da7b25e873b42e9058058cd9d",
  "scopes": [
    "read_manbo"
  ],
  "token": "ea5d0a593b2655e9568f144fb1826342292f5c6b7d406fda00577b8d1530d8a5"
}

HTTP/1.1 201

Content-Type: application/json

{

"client_id": "a91f0396a0968ff593eafdd194e3d17d32c41b1da7b25e873b42e9058058cd9d",

"scopes": [

"read_manbo"

"token": "ea5d0a593b2655e9568f144fb1826342292f5c6b7d406fda00577b8d1530d8a5"

}

DELETE /api/v1/access_tokens/:access_token

指定されたアクセストークンを失効させ、それ以降利用できないようにします。

DELETE /api/v1/access_tokens/:access_token HTTP/1.1
Host: api.manbo.link

1 2	DELETE /api/v1/access_tokens/:access_token HTTP/1.1 Host: api.manbo.link

HTTP/1.1 204

1	HTTP/1.1 204