인증

인증 방식

씨미 OpenAPI는 두 가지 인증 방식을 지원합니다.

Client ID/Secret 사용 예시

GET /api/openapi/open/v1/channels?channelIds=12345
Client-Id: {clientId}
Client-Secret: {clientSecret}

Access Token 사용 예시

GET /api/openapi/open/v1/users/me
Authorization: Bearer {accessToken}

애플리케이션 등록

API를 사용하려면 먼저 개발자 포탈에서 애플리케이션을 등록해야 합니다.

1. 개발자 포탈(/applications)에 로그인합니다.
2. + 새 애플리케이션 버튼을 눌러 애플리케이션을 생성합니다.
3. 생성된 Client ID와 Client Secret을 안전하게 보관합니다.
4. OAuth 인증에 사용할 Redirect URI를 설정합니다.

Client Secret은 외부에 노출되지 않도록 주의하세요. 서버 사이드 코드에서만 사용하는 것을 권장합니다.

애플리케이션 이름 규칙

OAuth 2.0 Authorization Code Flow

사용자 권한이 필요한 API를 호출하려면 OAuth 2.0 Authorization Code Flow를 통해 Access Token을 발급받아야 합니다.

전체 흐름

1. 사용자를 씨미 인증 페이지로 리디렉트
   → https://ci.me/auth/openapi/account-interlock
     ?clientId={clientId}
     &redirectUri={redirectUri}
     &state={state}

2. 사용자가 권한 승인

3. 씨미가 Redirect URI로 Authorization Code 전달
   → https://your-app.com/callback?code={authorizationCode}&state={state}

4. Authorization Code로 Access Token 발급
   POST /api/openapi/auth/v1/token
   {
     "grantType": "authorization_code",
     "clientId": "{clientId}",
     "clientSecret": "{clientSecret}",
     "code": "{authorizationCode}"
   }

5. Access Token으로 API 호출
   Authorization: Bearer {accessToken}

6. 토큰 만료 시 Refresh Token으로 갱신
   POST /api/openapi/auth/v1/token
   {
     "grantType": "refresh_token",
     "clientId": "{clientId}",
     "clientSecret": "{clientSecret}",
     "refreshToken": "{refreshToken}"
   }

토큰 유효 시간

토큰 발급 API

POST /api/openapi/auth/v1/token

응답:

{
  "code": 200,
  "message": null,
  "content": {
    "accessToken": "eyJhbGciOiJ...",
    "refreshToken": "dGhpcyBpc...",
    "tokenType": "Bearer",
    "expiresIn": "3600",
    "scope": "READ:USER READ:CHANNEL"
  }
}

토큰 취소 API

POST /api/openapi/auth/v1/token/revoke

Scope 레퍼런스

Scope는 Access Token이 접근할 수 있는 API 범위를 정의합니다.