토큰

Request

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

Access 토큰을 발급 요청합니다.

post

Access 토큰을 발급 요청합니다.

RCS Biz Center 웹에서 가입 시 등록한 ID(마스터 또는 매니저, 대행사)와 계정 가입 시 자동 생성되는 API Key(RCS Biz Center 내 계정관리에서 확인)를 이용하여 토큰 발급을 요청합니다.

response로 전달되는 expiresIn 시간이 초과하면 토큰을 새로 발급 받아야 합니다.

• API 사용 Client의 IP는 RCS Biz Center에서 등록하여야 합니다. Client IP 등록은 내 계정관리에서 ID별 최대 10개까지 등록할 수 있습니다.

• 계정 권한 : 마스터, 매니저, 대행사

Authorizations

Body

clientIdstring · max: 20Required

RCS Biz Center에 계정 가입시 등록한 ID 입니다.

clientSecretstring · max: 18Required

RCS Biz Center 내 계정관리 > 서비스 정보 : API Key 에서 확인 가능합니다.

post

HTTPcURLJavaScriptPython

POST /api/1.1/token HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "clientId": "text",
  "clientSecret": "text"
}

❖ request body sample

토큰발급요청

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

Response

필드명	타입	길이	필수여부	기본값	설명
accessToken	string		O		엑세스토큰
expiresIn	string		O		유효기간

❖ response body sample

200

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

401

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

error code는 RCS Biz Center - Response body error code 참조