Skip to main content
토큰을 안전하게 등록합니다. 최대 100,000개까지 등록 가능하며, 요청 당 최대 500개까지 처리할 수 있습니다.
프라이빗 모드 및 암호화 설정 보안 기능을 통해 데이터를 안전하게 전송할 수 있습니다.

기본 정보

string
필수
POST

보안 설정

암호화 옵션

안전한 데이터 전송 옵션을 활성화하면 요청 및 응답이 AES-256으로 암호화됩니다.
  • 암호화 방식: AES-256
  • 적용 범위: 요청 및 응답 데이터
  • 호환성: POST/submission, PATCH/submission, GET/submission과 동일한 암/복호화 방식
  • 안전한 데이터 전송 옵션 확인하기

인증

string
필수
프로젝트 API 키를 설정합니다.
string
필수
요청 본문의 MIME 타입을 설정합니다.
POST 요청 시 Content-Type: application/json사용 시 요청이 실패할 경우 text/plain를 사용하세요.

요청 파라미터

Request Body

Array<String>
필수
추가할 토큰 ID 배열 (1회 요청 시 최대 500개)토큰 ID 형식 제약사항:
  • 길이: 8 Byte ~ 64 Byte
  • 허용 문자: 영문자(a-z, A-Z), 숫자(0-9), 하이픈(-), 언더스코어(_), 마침표(.)
  • 제한: 공백, 탭, 개행문자 불가
  • 시작/끝: 영문자 및 숫자만 가능

응답

성공 응답 (200)

Boolean
작업 성공 여부
String
작업 결과 메시지
Object
요약 정보
Object
상세 정보 (실패 시에만 포함)

오류 응답 (400/500)

String
필수
에러 코드
String
필수
에러 메시지
Object
에러 상세 정보 (선택적)

토큰 정책

제한 사항

Token Pool: 각 PID 별 최대 100,000개 (초과 시 에러 발생) 1회 요청: 최대 500개 토큰 ID
중요: 토큰 풀이 100,000개를 초과하면 에러가 발생합니다. 토큰 수 관리를 위해서 다음의 두가지 방법을 활용할 수 있습니다.
  • DELETE 토큰 삭제 API를 사용하여 불필요한 토큰을 미리 정리.
  • 대시보드 프라이빗 모드 설정에서 ‘Token Id 삭제 조건 설정’에서 토큰 만료 시 삭제 옵션 활성화; 사용된 토큰은 자동적으로 삭제됩니다.

Partial Handling

POST 요청은 토큰 ID에 대해 부분적으로 처리됩니다. 이미 Pool에 존재하는 토큰 ID는 덮어쓰기되며, 별도 중복 에러는 반환되지 않습니다.
예시:
  • Pool에 존재하는 Token ID: tokenA, tokenB, tokenC
  • POST 요청: tokenA, tokenC, tokenD
  • 요청 완료 후 Pool: tokenA, tokenB, tokenC, tokenD

에러 코드

공통 에러

Token 관련 에러

암호화 설정을 통해 민감한 토큰 데이터를 안전하게 전송할 수 있습니다. 프로덕션 환경에서는 보안을 위해서 암호화 옵션을 활성화하여 고려할 수 있습니다.
Content-Type 주의사항: POST 요청 시 Content-Type: application/json을 사용했을 때 오류가 나는 경우 text/plain으로 헤더를 설정하세요.