{
  "slug": "ref/manual/bizspring-air-api-auth-token-인증-토큰-발행",
  "doc_type": "ref",
  "title": "Auth Token(인증 토큰) 발행 — BizSpring AIR™ API",
  "title_en": null,
  "one_liner": "BizSpring AIR™ API를 사용하는 클라이언트 인증을 통해 API 사용 자격을 획득합니다. Auth Token(인증 토큰) 발행 인증 토큰 발행하기 인증 토큰은 Growth Platform™ API를 사용하기 위해 먼저 발행해야 하는 항목입니다. 토큰은",
  "summary_bullets": [
    "Growth Platform™ API 사용 전 인증 토큰을 발행받는 방법을 설명한다.",
    "https://growthplatform.ai/auth/signin 에 username, password를 JSON으로 POST하여 토큰을 발급받는다.",
    "발급된 토큰은 API 요청 헤더에 Authorization: Bearer {ACCESS_TOKEN} 형태로 포함해야 한다.",
    "응답 결과에는 token_type(Bearer 고정)과 만료 기간이 있는 token 값이 포함된다.",
    "400/401/403/429 등 오류 코드와 각 상황(파라미터 누락, 인증 오류, 권한 없음, 요청 한도 초과)이 정의되어 있다."
  ],
  "body_md": "# Auth Token(인증 토큰) 발행\n\n## 인증 토큰 발행하기\n\n인증 토큰은 Growth Platform™ API를 사용하기 위해 먼저 발행해야 하는 항목입니다.\n\n* 토큰은 API 요청을 보낼 때 클라이언트를 인증하는데 사용되며, 각 요청 시 헤더에 포함되어야 합니다.\n* 요청 성공 시 응답은 토큰과 토큰 정보를 포함합니다.\n\n> API 사용을 위해서는 활성화된 API 사용 권한을 보유한 Growth Platform™ 계정이 필요합니다.\n>\n> 계정 생성 또는 API 사용 권한이 있는지 확인이 필요한 경우 growth-platform-tm을 참고합니다.\n\n### 인증 방식\n\n모든 API 요청 헤더에 포함:\n\nhttp\n\n```http\nAuthorization: Bearer {ACCESS_TOKEN}\n```\n\n### **요청 URL**\n\n아래 요청 URL로 계정 정보를 함께 요청하는 것으로서 인증 토큰을 발행 받고 획득하게 됩니다.\n\n**https://growthplatform.ai/auth/signin\n**\n\n### 프로토콜\n\nHTTPS\n\n### **HTTP 메서드**\n\nPOST\n\n### Request Body\n\nRequest Body를 JSON 형식으로 전달(요청) 합니다.\n\n| 키 | 타입 | 설명 |\n| --- | --- | --- |\n| username | string | 사용자 계정의 고유 아이디를 의미합니다. |\n| password | string | 사용자 계정의 고유 비밀번호를 의미합니다. |\n\n### 요청 예\n\n```http\nPOST /auth/signin\nHEADER\nContent-Type: application/json\n\nBODY\n{\n\"username\": \"{ADMIN_ID}\",\n\"password\": \"{ADMIN_PW}\"\n}\n\n# JavaScript JQuery\nconst sendData = {\n'username': \"{username}\",\n'password': \"{password}\"\n};\n\nlet token;\n$.ajax({\nurl: 'https://growthplatform.ai/auth/signin',\nmethod: 'POST',\ncontentType: 'application/json; charset=utf-8',\ndata: JSON.stringify(sendData),\nsuccess: function (data) {\n// success\ntoken = data.token;\n},\nerror: function (error) {\n// error\n}\n});\n```\n\n### 응답 결과 데이터\n\n응답에 성공하면 JSON 형식으로 결과값이 반환됩니다.\n\n| 파라미터 | 타입 | 설명 |\n| --- | --- | --- |\n| token_type | string | 발행된 토큰의 타입. Bearer 로 고정 |\n| token | string | 리포트 데이터 요청 시 사용되는 만료 기간이 있는 토큰 |\n\n### 응답 예\n\n**HTTP/1.1 200 OK\n**Content-Type: application/json;charset=UTF-8\n\n**{\n** \"token_type\": \"Bearer\",\n\"token\": \"eyJraWQiOiI0ZGE2YmYxNy0wYTZmL....SrYiSAX7lZhc-rxKbrooQ8KQ-Dq7CV1tA\"\n}\n\n> HTTP Request에 대한 200 OK 응답이 아닌 경우는 username 및 password의 오류가 아닌, 클라이언트-API서버와의 통신문제이거나 기타 문제입니다.\n>\n> 이 경우에는 HTTP 표준 응답 코드를 참고하시기 바랍니다.\n\n### 오류 코드\n\n| HTTP | 오류 코드 | 설명 |\n| ---- | ------------------- | -------------------- |\n| 400 | invalid\\_request | 필수 파라미터 누락 |\n| 401 | invalid\\_client | client\\_id/secret 오류 |\n| 403 | access\\_denied | 접근 권한 없음 |\n| 429 | too\\_many\\_requests | 요청 한도 초과 |\n\n***\n\n### 추가 예시\n\n#### 토큰 발행 — cURL\n\n```bash\ncurl -X POST https://api.bizspring.co.kr/air/v1/auth/token \\\n-H \"Content-Type: application/json\" \\\n-d '{\n\"client_id\": \"your_client_id\",\n\"client_secret\": \"your_client_secret\",\n\"grant_type\": \"client_credentials\"\n}'\n```\n\n```python\nimport requests\n\ndef get_access_token(client_id: str, client_secret: str) -> str:\nurl = \"https://api.bizspring.co.kr/air/v1/auth/token\"\npayload = {\n\"client_id\": client_id,\n\"client_secret\": client_secret,\n\"grant_type\": \"client_credentials\"\n}\nresponse = requests.post(url, json=payload)\nresponse.raise_for_status()\nreturn response.json()[\"access_token\"]\n\ntoken = get_access_token(\"your_client_id\", \"your_client_secret\")\n```\n\n```javascript\nasync function getAccessToken(clientId, clientSecret) {\nconst response = await axios.post(\n'https://api.bizspring.co.kr/air/v1/auth/token',\n{ client_id: clientId, client_secret: clientSecret, grant_type: 'client_credentials' }\n);\nreturn response.data.access_token;\n}\n```\n\n#### 응답 예시\n\njson\n\n```json\n{\n\"access_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n\"token_type\": \"Bearer\",\n\"expires_in\": 86400\n}\n```",
  "related_slugs": [],
  "keywords": [],
  "faq": [
    {
      "a": "먼저 Growth Platform™ API 사용을 위한 인증 토큰을 발행받아야 합니다. 이를 위해서는 활성화된 API 사용 권한을 보유한 Growth Platform™ 계정이 필요합니다.",
      "q": "API를 사용하려면 뭐가 먼저 필요한가요?"
    },
    {
      "a": "https://growthplatform.ai/auth/signin 으로 username과 password를 JSON 형식의 Request Body에 담아 POST 요청을 보내면 됩니다. 요청이 성공하면 token_type과 token 값이 담긴 JSON 응답을 받습니다.",
      "q": "토큰은 어떻게 발급받나요?"
    },
    {
      "a": "모든 API 요청의 헤더에 Authorization: Bearer {ACCESS_TOKEN} 형태로 포함시켜야 합니다.",
      "q": "발급받은 토큰은 어떻게 사용하나요?"
    },
    {
      "a": "아닙니다. 200 OK가 아닌 응답은 username/password 오류가 아니라 클라이언트-API서버 간 통신 문제이거나 기타 문제일 수 있습니다. 이 경우 HTTP 표준 응답 코드를 참고해야 합니다.",
      "q": "요청이 200 OK로 안 오면 아이디/비밀번호가 틀린 건가요?"
    },
    {
      "a": "400 invalid_request(필수 파라미터 누락), 401 invalid_client(client_id/secret 오류), 403 access_denied(접근 권한 없음), 429 too_many_requests(요청 한도 초과)가 정의되어 있습니다.",
      "q": "오류가 나면 어떤 코드들을 확인해야 하나요?"
    }
  ],
  "jsonld": null,
  "image_url": null,
  "caption": null,
  "width": null,
  "height": null,
  "video_url": null,
  "duration_sec": null,
  "thumbnail_url": null,
  "solution_slug": null,
  "source_id": "gitbook:UJ9uzvHT9r6QImnjP8p4:UStLvmGyPcHeKP8Ts6zB",
  "created_at": "2026-08-23T14:32:38.444294+00:00",
  "updated_at": "2026-09-03T04:45:04.383+00:00",
  "backlinks": [],
  "html_url": "https://bizspring.ai/kb/ref/manual/bizspring-air-api-auth-token-인증-토큰-발행",
  "markdown_url": "https://bizspring.ai/kb/ref/manual/bizspring-air-api-auth-token-인증-토큰-발행.md"
}