GuidesAPI GuideChangelog
Log In
API Guide

액세스 토큰 발급

API 를 호출할 때 필요한 액세스 토큰을 발급받습니다.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
  • OAuth 2.0 Client Credentials 방식입니다. 모비두 운영팀에서 발급받은 clientId·clientSecret 으로 요청합니다.
  • 토큰은 1시간 동안 유효합니다. refresh token 은 없으며, 만료되면 같은 요청으로 다시 발급받습니다.
  • 호출할 때마다 새로 발급받지 말고, 만료 전까지 저장해 두고 재사용하세요.
📘

clientId · clientSecret 이 없다면 모비두 고객성공팀에 문의해 주세요.

이메일 [email protected] · 카카오톡 채널로 문의하세요.

요청

위치이름필수설명
헤더AuthorizationYBasic {base64(clientId:clientSecret)}. 본문에 client_id·client_secret 을 넣는 방식도 지원합니다.
헤더x-api-versionYAPI 버전. 없거나 다르면 400 G010. 예: 2026-10-28
헤더Content-TypeYapplication/x-www-form-urlencoded
헤더X-Request-IdN요청 추적 ID. 보내지 않으면 서버가 만듭니다. 응답 헤더로 항상 돌려줍니다
폼 데이터grant_typeYclient_credentials 고정

응답

필드타입설명
access_tokenstringAPI 호출에 쓰는 액세스 토큰. Authorization: Bearer {access_token} 으로 보냅니다
token_typestringBearer
expires_ininteger남은 유효 시간(초). 약 3600

오류

  • 400 G010 — x-api-version 헤더가 없거나 값이 다름. 본문 형식은 오류 코드와 같습니다
  • 401 {"error": "invalid_client"} — clientId·clientSecret 이 틀렸거나 폐기됨
  • 400 {"error": "invalid_request"} — grant_type 이 없음
  • 400 {"error": "unsupported_grant_type"} — grant_type 이 client_credentials 가 아님

clientId·clientSecret 을 먼저 확인하므로, 자격 증명이 틀리면 grant_type 오류보다 401 invalid_client 가 먼저 납니다.

Form Data
string
enum
required
Defaults to client_credentials

client_credentials 고정

Allowed:
string

클라이언트 ID. Basic 인증 대신 본문으로 보낼 때만 사용합니다

string

클라이언트 secret. Basic 인증 대신 본문으로 보낼 때만 사용합니다

Headers
string
required
Defaults to 2026-10-28

API 버전 (날짜 형식). 이 명세는 2026-10-28 버전입니다. 없거나 다르면 400 G010 입니다.

string

요청 추적 ID(선택). 영문·숫자·- _ . : 128자 이하. 보내지 않거나 형식이 다르면 서버가 만들어 응답 헤더로 돌려줍니다.

Responses

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
🏠 소스라이브 🎬 소스클립 🔗 소스링크 📢 소스애드
🧩 API 가이드
🆕 최근 업데이트
💬 도움이 더 필요하신가요?
메일로 문의 카카오톡 채널로 문의
담당자에게 문의하기

궁금한 점이나 불편했던 점을 남겨주시면 담당자가 확인 후 답변드릴게요.

가이드 챗봇
* AI를 활용해 답변해서 사실과 다를 수도 있어요. 더 궁금한 사항은 '담당자에게 문의하기'를 이용해주세요.
💡 궁금한 솔루션(예: 라이브, 링크 등)을 함께 적어주시면 더 정확한 답변을 받을 수 있어요.