토큰 발급

01 토큰 발급

1.1 설명

POST/auth/token

키가 여러 워크스페이스에 닿을 수 있어도, 토큰 하나는 발급할 때 고른 한 곳에만 통합니다. 다른 워크스페이스를 다루려면 그 코드로 토큰을 다시 받으십시오.

1.2 파라미터

토큰 발급 파라미터
이름	구분	설명
`api_key`	필수	앱에서 발급받은 키 평문입니다. `mc_live_` 로 시작합니다
`workspace`	필수	이 토큰으로 다룰 워크스페이스 코드입니다. 앱 주소 `/app/w/{code}` 의 code 와 같습니다

1.3 요청

Terminal — bash

curl -X POST https://moacast.com/api/moacast/v1/auth/token \
  -H 'Content-Type: application/json' \
  -d '{"api_key":"mc_live_xxxxxxxxxxxx","workspace":"a1b2c3d4"}'

1.4 성공 응답

Response — JSON

{
    "result": "SUCCESS",
    "result_code": 0,
    "data": {
        "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
        "token_type": "Bearer",
        "expires_in": 3600,
        "workspace": "a1b2c3d4"
    }
}

1.5 필드

토큰 발급 필드
필드	타입	설명
`access_token`	`string`	이후 호출의 `Authorization: Bearer` 에 그대로 싣습니다
`token_type`	`string`	언제나 `Bearer` 입니다
`expires_in`	`int`	남은 수명(초). 지금 3600 입니다
`workspace`	`string`	이 토큰이 다룰 수 있는 워크스페이스 코드

1.6 실패

토큰 발급 실패
코드	HTTP	언제
`1001`	401	키가 없거나 폐기되었거나, 그 키로 다룰 수 없는 워크스페이스입니다. 어느 쪽인지 가려 알려 주지 않습니다
`9912`	400	`api_key` 나 `workspace` 를 주지 않았습니다
`4290`	429	1분에 30회를 넘겼습니다