# 토큰

## Request

인증용 토큰 발급/갱신 API 목록입니다. 마스터, 매니저, 대행사의 계정 ID와 API KEY로 인증 발급됩니다. 발급된 token은 모든 API의 header에 삽입되어야 합니다.

## Access 토큰을 발급 요청합니다.<br>

> Access 토큰을 발급 요청합니다.  \
> \
> RCS Biz Center 웹에서 가입 시 등록한 ID(마스터 또는 매니저, 대행사)와 계정 가입 시 자동 생성되는 API\
> Key(RCS Biz Center 내 계정관리에서 확인)를 이용하여 토큰 발급을 요청합니다.  \
> \
> response로 전달되는 expiresIn 시간이 초과하면 토큰을 새로 발급 받아야 합니다.          \
> \
> &#x20; \+ \*\*API 사용 Client의 IP는 RCS Biz Center에서 등록하여야 합니다. Client IP 등록은 내 계정관리에서 ID별 최대 10개까지 등록할 수 있습니다.\*\*          \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저, 대행사\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.12"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}}},"paths":{"/token":{"post":{"summary":"Access 토큰을 발급 요청합니다.\n","description":"Access 토큰을 발급 요청합니다.  \n\nRCS Biz Center 웹에서 가입 시 등록한 ID(마스터 또는 매니저, 대행사)와 계정 가입 시 자동 생성되는 API\nKey(RCS Biz Center 내 계정관리에서 확인)를 이용하여 토큰 발급을 요청합니다.  \n\nresponse로 전달되는 expiresIn 시간이 초과하면 토큰을 새로 발급 받아야 합니다.          \n\n  + **API 사용 Client의 IP는 RCS Biz Center에서 등록하여야 합니다. Client IP 등록은 내 계정관리에서 ID별 최대 10개까지 등록할 수 있습니다.**          \n  + **계정 권한 : 마스터, 매니저, 대행사**\n","requestBody":{"description":"required: true\n","content":{"application/json":{"schema":{"type":"object","properties":{"clientId":{"type":"string","description":"RCS Biz Center에 계정 가입시 등록한 ID 입니다.\n","maxLength":20},"clientSecret":{"type":"string","description":"RCS Biz Center 내 계정관리 > 서비스 정보 : API Key 에서 확인 가능합니다.\n","maxLength":18}},"required":["clientId","clientSecret"]}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body sample

{% tabs %}
{% tab title="토큰발급요청" %}

```
{
  "clientId": "myMemberId",
  "clientSecret": "SK.atIs4g04r6PJepf"
}
```

{% endtab %}
{% endtabs %}

## Response

<table data-full-width="true"><thead><tr><th width="185">필드명</th><th width="154">타입</th><th width="85" align="center">길이</th><th width="113" align="center">필수여부</th><th width="84">기본값</th><th>설명</th></tr></thead><tbody><tr><td><code>accessToken</code></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>엑세스토큰</td></tr><tr><td><code>expiresIn</code></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>유효기간</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "expiresIn": "1717138601944",
    "accessToken": "eyJhbGciOiJIUzI1NiJ9.eyJzdWJBZ25jeUlkIjoiIiwiaXNTdWJBZ2VuY3kiOiJuIiwiZXhwaXJlRGF0ZSI6IjIwMjQtMDUtMzEgMTU6NTY6NDEiLCJ1c2VySWQiOiJzd2plb25nMzExNyIsImFsbG93SXAiOiIyMTEuMTY5LjE1My4xNzAiLCJjcmVhdGVEYXRlIjoiMjAyNC0wNS0zMSAxNDo1Njo0MSJ9.TPpsOjjA51Snw5p5r6kabWeYH73Gr2PXFENBIVR6ovI"
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61006",
        "message": "Invalid secret key"
    },
    "status": 401
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](https://apidocs.rcsbizcenter.com/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}