DELETE/Token

등록된 토큰을 안전하게 삭제합니다. 최대 5,000개까지 일괄 삭제 가능하며, 부분적 처리를 지원합니다.

토큰 삭제는 되돌릴 수 없는 작업입니다. 삭제 전 신중히 검토하시기 바랍니다.

기본 정보

method

string

required

DELETE

url

string

required

https://rest-api.argosidentity.com/v3/submission/tokens

보안 설정

암호화 전송

안전한 데이터 전송 옵션 활성화 시, 요청 및 응답이 AES-256으로 암호화됩니다.

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

데이터 보안

삭제된 토큰 데이터는 완전히 제거되며, 복구가 불가능합니다. 안전한 데이터 전송에서는 삭제 과정도 암호화되어 진행됩니다.

인증

x-api-key

string

required

프로젝트 API 키를 설정합니다.

Content-Type

string

요청 본문의 MIME 타입을 설정합니다.

DELETE 요청 시 Content-Type: application/json을 사용했을 때, 오류가 발생 시, 'text/plain을 사용하세요.

x-api-key: {{YOUR_API_KEY}}
Content-Type: text/plain

토큰 삭제 유형

tokenId 지정 삭제

특정 tokenId를 지정해서 삭제 (요청 당 최대 500개)

시간 순 N개 삭제

제출한 순서 및 갯수에 따른 N개 삭제 (요청 당 최대 5,000개)

요청 파라미터

Request Body

tokenId

Array<String>

required

삭제할 토큰 ID 배열 (최대 500개)토큰 ID 형식:

길이: 8 Byte ~ 64 Byte
허용 문자: 영문자(a-z, A-Z), 숫자(0-9), 하이픈(-), 언더스코어(_), 마침표(.)
제한: 공백, 탭, 개행문자 불가
시작/끝: 영문자 및 숫자만 가능

curl -X DELETE 'https://rest-api.argosidentity.com/v3/submission/tokens' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: text/plain' \
  -d '{
  "tokenId": [
    "user001a",
    "api.key.01",
    "token-123-abc", 
    "session_data_01"
  ]
}'

응답

성공 응답 (200)

success

Boolean

required

작업 성공 여부

message

String

required

작업 결과 메시지

summary

Object

required

요약 정보

Show summary 속성

totalSubmitted

Number

제출된 총 토큰 수

deleted

Number

성공적으로 삭제된 토큰 수

notFound

Number

존재하지 않는 토큰 수

failed

Number

삭제 실패한 토큰 수

details

Object

상세 정보 (실패나 존재하지 않는 토큰이 있는 경우에만 포함)

Show details 속성

notFound

Array<String>

존재하지 않는 토큰 목록

failed

Array<Object>

삭제 실패한 토큰 목록

Show failed 배열 속성

tokenId

String

삭제 실패한 토큰 ID

error

String

삭제 실패 코드

message

String

삭제 실패 메시지

{
  "success": true,
  "message": "Successfully deleted 3 tokens",
  "summary": {
    "totalSubmitted": 3,
    "deleted": 3,
    "notFound": 0,
    "failed": 0
  }
}

오류 응답 (400/500)

errorCode

String

required

에러 코드

errorMessage

String

required

에러 메시지

{
  "errorCode": "token_not_found",
  "errorMessage": "Token not found."
}

토큰 정책

제한 사항

요청 제한: 1회 요청 당 최대 5000개 토큰 ID Pool 제한: 각 PID별 최대 100,000개 토큰 관리

Partial Handling

DELETE 요청은 토큰 ID에 대해 부분적으로 처리됩니다. Pool에 존재하지 않는 토큰 ID는 응답의 ‘notFound’ 필드로 안내하고, 존재하는 토큰 ID만 삭제합니다.

예시:

Pool에 존재하는 Token ID: tokenA, tokenB, tokenC
DELETE 요청: tokenA, tokenC, tokenD
요청 완료 후 Pool: tokenB
응답의 details.notFound: [tokenD]

보안 고려사항

데이터 완전 삭제

프라이빗 모드에서 삭제된 토큰은 암호화된 상태에서 완전히 제거되어 복구가 불가능합니다.

안전한 삭제: 데이터베이스에서 완전 제거
암호화 처리: 삭제 과정도 AES-256/GCM-256 암호화 적용
감사 로그: 삭제 작업 기록 유지 (토큰 내용은 제외)

접근 제어

삭제 권한은 API 키를 통해 제어됩니다. API 키 관리에 각별한 주의가 필요합니다.

에러 코드

공통 에러

Error Code	HTTP Status	Description
invalid_payload	400	요청 페이로드 누락 또는 형식 오류
invalid_path	400	지원하지 않는 HTTP 메서드
invalid_project	400	프로젝트 ID 누락 또는 잘못된 API 키
invalid_query_parameters	400	쿼리 파라미터 누락 또는 형식 오류
invalid_order	400	쿼리 파라미터의 정렬(order) 형식 오류
internal_server_error	500	서버 내부 오류

Token 관련 에러

Error Code	HTTP Status	Description
invalid_token_id	400	토큰 ID 누락, 빈 값, 또는 배열이 아님
invalid_token_id_format	400	토큰 ID 형식 규칙 위반
invalid_token_id_type	400	토큰 ID가 문자열이 아님
invalid_token_id_length	400	토큰 ID 길이가 8-64자 범위를 벗어남
invalid_token_id_whitespace	400	토큰 ID에 공백 문자 포함
invalid_token_id_characters	400	토큰 ID에 허용되지 않는 문자 포함
invalid_token_id_start	400	토큰 ID가 영문자/숫자로 시작하지 않음
invalid_token_id_end	400	토큰 ID가 영문자/숫자로 끝나지 않음
request_token_limit_exceeded	400	요청 당 토큰 개수 제한 초과 (500개)
token_limit_exceeded	400	프로젝트 당 토큰 총 개수 제한 초과 (100,000개)
token_id_not_found	400	요청한 토큰이 풀에 존재하지 않음
token_id_details_not_found	400	토큰 상세 정보 조회 실패
delete_token_limit_exceeded	400	시간 순 다건 삭제 요청의 최대 갯수(count) 초과 (5000개)

사용 예시

삭제 대상 토큰 확인

삭제하기 전에 토큰이 존재하는지 확인합니다.

curl -X GET 'https://rest-api.argosidentity.com/v3/submission/tokens?tokenId=user001a' \
  -H 'x-api-key: YOUR_API_KEY'

토큰이 존재하는 경우 상세 정보가 반환됩니다.

토큰 삭제 실행

확인된 토큰을 삭제합니다. 유형: 토큰 지정 삭제, 토큰 시간 순 삭제

Show 토큰 지정 삭제

curl -X DELETE 'https://rest-api.argosidentity.com/v3/submission/tokens' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: text/plain' \
  -d '{"tokenId": ["user001a", "api.key.01"]}' 

Show 토큰 시간 순 삭제

curl -X DELETE 'https://rest-api.argosidentity.com/v3/submission/tokens' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: text/plain' \
  -d '{"count": 5000, order: "asc"}' 

삭제는 즉시 실행되며 되돌릴 수 없습니다.

삭제 결과 확인

응답에서 삭제 결과를 확인합니다.

summary.deleted 필드에서 성공적으로 삭제된 토큰 수를 확인할 수 있습니다.

대량 삭제 시에는 존재하지 않는 토큰이 포함되어도 존재하는 토큰만 선별적으로 삭제됩니다. details.notFound에서 존재하지 않았던 토큰 목록을 확인할 수 있습니다.

Content-Type 주의사항: DELETE 요청 시 Content-Type: application/json을 사용했을 때, 오류가 발생 시, 'text/plain을 사용하세요.

개요

API 참조

데이터 구조 가이드

기본 정보

보안 설정

암호화 전송

데이터 보안

인증

토큰 삭제 유형

요청 파라미터

Request Body

응답

성공 응답 (200)

오류 응답 (400/500)

토큰 정책

제한 사항

Partial Handling

보안 고려사항

데이터 완전 삭제

접근 제어

에러 코드

공통 에러

Token 관련 에러

사용 예시

개요

API 참조

데이터 구조 가이드

​기본 정보

​보안 설정

​암호화 전송

​데이터 보안

​인증

​토큰 삭제 유형

​요청 파라미터

​Request Body

​응답

​성공 응답 (200)

​오류 응답 (400/500)

​토큰 정책

​제한 사항

​Partial Handling

​보안 고려사항

​데이터 완전 삭제

​접근 제어

​에러 코드

​공통 에러

​Token 관련 에러

​사용 예시

기본 정보

보안 설정

암호화 전송

데이터 보안

인증

토큰 삭제 유형

요청 파라미터

Request Body

응답

성공 응답 (200)

오류 응답 (400/500)

토큰 정책

제한 사항

Partial Handling

보안 고려사항

데이터 완전 삭제

접근 제어

에러 코드

공통 에러

Token 관련 에러

사용 예시