사용자 식별 키

익명 사용자 식별 키 검증하기

post

x-anon-key 헤더로 전달한 익명 사용자 식별 키가 유효한지 검증해요.

비즈니스 오류 코드

아래 오류는 HTTP 200과 resultType: FAIL로 응답해요.

errorCode	설명
4010	인증 정보를 찾을 수 없어요.
4095	요청 한도를 초과했습니다. 잠시 후 다시 시도해주세요.

요청 한도: 앱당 분당 3,000회

Authorizations

mutualTLS

파트너에게 발급된 클라이언트 인증서 기반 mTLS 인증이에요. 인증서의 CN으로 미니앱을 식별해요. 인증서 발급·관리 방법은 서버 API 이용하기 문서를 참고하세요.

Header parameters

x-anon-keystringRequired

사용자를 인증하기 위한 키예요. 미니앱 SDK의 User.getAnonymousKey 함수로 발급받을 수 있어요

Example: kQ7pL2mZxN9wRt5vB8yD3jF6cA1

Responses

200

익명 사용자 식별 키 검증 결과가 true 또는 false로 돌아와요.

application/json

or

400

요청 형식이 올바르지 않아요. error.data는 빈 객체이고 error.reason은 Unknown Error로 내려가요. x-anon-key 헤더 누락은 이 응답이 아니라 HTTP 200의 비즈니스 오류(4010)로 내려가요.

application/json

500

분류되지 않은 서버 오류예요. 계속 실패하면 파트너 지원 채널로 문의해 주세요.

application/json

post/api-partner/v1/apps-in-toss/users/anon-key/verify

POST /api-partner/v1/apps-in-toss/users/anon-key/verify HTTP/1.1
Host: apps-in-toss-api.toss.im
x-anon-key: {anonKey}

{
  "resultType": "SUCCESS",
  "success": true
}