SaaS API크리에이터 DM 인증
인증 링크 발급
크리에이터 본인이 인스타그램 계정 인증용 ig.me 링크를 발급받습니다.
인증 링크 발급
로그인한 크리에이터가 자기 인스타그램 계정을 인증할 ig.me 링크를 발급받습니다.
유효시간 안에 한 번만 사용됩니다.
HTTP 요청
POST /ai/influence/dm-link/token?applicationId=7240&locale=ko
Authorization: Bearer {access_token}Query Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
applicationId | Integer | 예 | 인증 대상 신청(TB_CAMPAIGN_APPLICATION.id) |
locale | String | 아니오 | 화면 로케일. ko / ja / jp / en. 미지정 시 한국어 |
선택 파라미터지만 실질적으로 필수입니다. 인증 결과를 크리에이터에게 DM 으로 회신할 때
어느 말로 답할지가 이 값으로 정해지고, 웹훅에는 언어를 알 단서가 없습니다.
일본어 경로가 ja 가 아니라 jp 인 화면이 있어 둘 다 받습니다.
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "발급 완료",
"data": {
"verifyUrl": "https://ig.me/m/glow.b_kor?ref=0ZIoudELbI1znz7lWeMVT4eA58zmPOuZ",
"verifyCode": "482913",
"expiresAt": "2026-09-08T13:03:59.123"
}
}| 필드 | 설명 |
|---|---|
verifyUrl | 크리에이터에게 보여줄 링크. 모바일은 링크, PC 는 QR. 그대로 사용 |
verifyCode | 6자리 인증 코드. 링크가 안 통할 때 대화창에 직접 입력하는 값 |
expiresAt | 만료 시각 (발급 1시간 뒤) |
에러 응답
| 상태 코드 | 코드 | 설명 |
|---|---|---|
401 | AUTH_TOKEN_REQUIRED · AUTH_TOKEN_EXPIRED | 인증 실패 |
404 | INVALID_INFLUENCE_USER | 크리에이터 정보 없음 |
404 | APPLICATION_NOT_FOUND | 신청을 찾을 수 없음 (args.applicationId) |
403 | APPLICATION_NOT_OWNED | 본인의 신청이 아님 |
400 | REQUEST_PARAM_REQUIRED · PATH_VARIABLE_INVALID | applicationId 누락·형식 오류 |
503 | DM_LINK_VERIFY_UNAVAILABLE | 기능 플래그(ig_dm_verify_enabled)가 꺼져 있음 |
500 | DM_LINK_CODE_ISSUE_FAILED | 6자리 코드 예약 실패 — 잠시 후 재시도 |
503 | CACHE_ERROR | Redis 장애 |
오류 코드 전체 목록과 다국어 매핑 방법은 크리에이터 오류 코드를 참고하세요.
상태 값은 HTTP 상태가 아니라 응답 본문의 status 입니다.
동작
- 토큰은 32바이트 난수를 URL-safe Base64 로 인코딩한 값이며 Redis 에 1시간 저장됩니다.
- 6자리 코드가 한 쌍으로 함께 발급됩니다. 어느 쪽으로 인증하든 나머지 하나도 같이 소모됩니다 — 이미 인증을 마친 사람의 코드가 남은 시간 동안 살아 있지 않게 하기 위해서입니다.
- 인증 단위는 신청입니다. 넘긴
applicationId가 정말 그 크리에이터의 신청인지 서버가 확인합니다 — 신청 번호는 추측 가능한 연번이라, 확인이 없으면 남의 신청에 자기 계정을 붙일 수 있습니다. - 토큰에는 크리에이터 번호와 로케일이 함께 담깁니다. 인증이 끝나 회신할 때 그 로케일을 씁니다.
- 인스타 핸들(
glow.b_kor)과 유효시간은 코드 상수입니다. 계정을 바꾸면 이미 인증된 IGSID 가 전부 무효가 되므로 설정으로 빼지 않았습니다.
같은 크리에이터가 여러 번 발급받아도 됩니다. 먼저 쓰인 토큰만 유효하고 나머지는 만료됩니다.