프라이빗 모드 및 암호화 설정 보안 기능을 통해 데이터를 안전하게 전송할 수 있습니다.
기본 정보
string
필수
POST
string
필수
KR 리전 프로젝트는 호스트를
kr.rest-api.argosidentity.com으로 바꿔 호출합니다. 자세한 내용은 리전 안내를 참고하세요.보안 설정
암호화 옵션
- 암호화 방식: AES-256
- 적용 범위: 요청 및 응답 데이터
- 호환성: POST/submission, PATCH/submission, GET/submission과 동일한 암/복호화 방식
- 안전한 데이터 전송 옵션 확인하기
인증
string
필수
프로젝트 API 키를 설정합니다.
string
필수
요청 본문의 MIME 타입을 설정합니다.
요청 파라미터
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
에러 상세 정보 (선택적)
토큰 정책
제한 사항
Partial Handling
POST 요청은 토큰 ID에 대해 부분적으로 처리됩니다.
이미 Pool에 존재하는 토큰 ID는 덮어쓰기되며, 별도 중복 에러는 반환되지 않습니다.
- Pool에 존재하는 Token ID:
tokenA,tokenB,tokenC - POST 요청:
tokenA,tokenC,tokenD - 요청 완료 후 Pool:
tokenA,tokenB,tokenC,tokenD
에러 코드
공통 에러
Token 관련 에러
이 페이지의 Liveform URL은 US 리전 프로젝트 기준입니다. KR 리전 프로젝트는 호스트가
form-kr.argosidentity.com입니다. 자세한 내용은 리전 안내를 참고하세요.Content-Type 주의사항: POST 요청 시
Content-Type: application/json을 사용했을 때 오류가 나는 경우 text/plain으로 헤더를 설정하세요.관련 문서
쿼리 스트링 및 토큰 가이드
Liveform의 쿼리 스트링 및 토큰 ID 옵션에 대한 종합 가이드입니다. 추가 정보 전송, 중복 제출 방지, 사용자 식별 등의 기능을 제공합니다. ID check 프로세스 최적화를 위한 필수 도구들을 알아보세요.
Token expired (토큰 만료)
이 이벤트는 Token ID가 설정된 만료 조건에 따라 만료될 때 트리거됩니다. Token Expiration 설정을 통해 사용 횟수 또는 시간 기반으로 토큰을 관리할 수 있으며, 토큰이 만료되면 자동으로 웹훅이 발송됩니다. 이를 통해 토큰의 수명 주기를 추적하고 재사용 문제를 방지할 수 있습니다.