로그인 크리에이터 본인의 인증·수신동의 상태를 조회합니다.

인증 상태 조회

로그인한 크리에이터가 자기 인증 상태를 확인합니다. 프론트가 인증 링크를 띄운 뒤 이걸 물어 완료 표시를 켭니다.

인증은 인스타그램 앱에서 일어나 화면으로 돌아오지 않으므로, 프론트가 결과를 알 방법이 이것뿐입니다.

HTTP 요청

GET /ai/influence/dm-link/status?applicationId=7240
Authorization: Bearer {access_token}

응답

성공 응답 (200 OK)

{
  "status": 200,
  "message": "조회 완료",
  "data": {
    "enabled": true,
    "verified": true,
    "notifyOptIn": true,
    "username": "glowb.tester3",
    "verifiedAt": "2026-09-07T19:04:46",
    "appliedHandle": "glowb.tester3",
    "handleMatched": true
  }
}

필드	타입	설명
`enabled`	`boolean`	기능이 켜져 있는가. `false` 면 인증 단계를 아예 감춘다
`verified`	`boolean`	계정 인증을 마쳤는가
`notifyOptIn`	`boolean`	수신 거부 기록. 인증되면 `true` 이고, 그만 받겠다고 한 경우에만 `false`
`username`	`String`	인증된 인스타 핸들. 인증 전이면 `null`
`verifiedAt`	`String`	인증 시각. 인증 전이면 `null`
`appliedHandle`	`String`	그 신청서에 적어낸 핸들(정규화)
`handleMatched`	`boolean`	신청서 핸들과 같았는가. 다르면 인증 자체가 거절되므로 `true` 또는 `null`(대조 불가)

인증 전

{
  "data": {
    "enabled": true,
    "verified": false,
    "notifyOptIn": false,
    "username": null,
    "verifiedAt": null
  }
}

수신 동의를 따로 받지 않습니다. 여기서 나가는 것은 이미 캠페인에 참여 중인 크리에이터에게 보내는 일정 공지이지 광고가 아니라서, 인증이 곧 발송 준비 완료입니다. notifyOptIn 은 나중에 "그만 받겠다"는 사람을 빼기 위한 수신 거부 기록이라 프론트가 화면 분기에 쓸 값이 아닙니다.

에러 응답

상태 코드	코드	설명
`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` 누락·형식 오류

기능 플래그가 꺼져 있어도 오류가 아닙니다. enabled: false 로 내려옵니다 — 프론트는 "감출지"를 알아야 하는데 예외로 받으면 "조회 실패"와 구분할 수 없습니다.

화면 상태 둘

`verified`	화면
`false`	인증하기 버튼 + 링크/QR
`true`	완료 — 인증된 계정(`username`)을 보여주면 된다

언제 호출하나

신청 폼 진입 시 1회 — 이미 인증했으면 링크를 안 띄워도 됩니다
인증 링크를 띄운 뒤 — 크리에이터가 인스타에서 돌아왔을 때 갱신

크리에이터가 인스타 앱으로 넘어갔다 돌아오는 흐름이라, 화면이 다시 보이는 시점 (visibilitychange 등)에 한 번 더 부르면 자연스럽습니다. 짧은 주기로 계속 폴링할 필요는 없습니다.

인증 상태 조회

On this page