GET /submission/tokens?tokenId=user001a

{
  "success": true,
  "tokenId": "user001a",
  "data": {
    "tokenId": "user001a",
    "updateTime": "2024-01-15T10:30:45.123Z"
  }
}
등록된 토큰을 안전하게 조회합니다. 단일 토큰 상세 조회 또는 전체 토큰 목록 조회가 가능합니다.
안전한 데이터 전송 옵션 활성화 시, 응답 데이터가 AES-256으로 암호화되어 전송됩니다.

​
기본 정보

​
method
string
required
GET
​
url
string
required
https://rest-api.argosidentity.com/v3/submission/tokens

​
보안 설정

​
암호화 옵션

안전한 데이터 전송 활성화 시 모든 응답 데이터가 AES-256 암호화로 보호됩니다.
  • 암호화 방식: AES-256
  • 적용 범위: 응답 데이터
  • 호환성: POST/submission, PATCH/submission, DELETE/submission, Webhook과 동일한 암/복호화 방식

​
인증

​
x-api-key
string
required
프로젝트 API 키를 설정합니다.
x-api-key: {{YOUR_API_KEY}}

​
요청 파라미터

​
Query Parameters

​
tokenId
String
특정 토큰 ID
  • 제공 시: 단일 토큰 상세 조회
  • 미제공 시: 전체 토큰 목록 조회
GET /submission/tokens?tokenId=user001a

​
응답

​
성공 응답 (200)

​
success
Boolean
required
조회 성공 여부
​
tokenId
String
required
조회된 토큰 ID
​
data
Object
required
토큰 데이터
{
  "success": true,
  "tokenId": "user001a",
  "data": {
    "tokenId": "user001a",
    "updateTime": "2024-01-15T10:30:45.123Z"
  }
}
data[‘expired’] 값을 통해, 기존에 제출한 것들 중, token이 만료된 건을 확인해서 DELETE-token에 활용할 수 있습니다.

​
오류 응답 (400/500)

​
errorCode
String
required
에러 코드
​
errorMessage
String
required
에러 메시지
{
  "errorCode": "token_not_found",
  "errorMessage": "Token not found."
}

​
보안 고려사항

​
데이터 보호

토큰 조회 시 민감한 정보가 포함될 수 있습니다. 프로덕션 환경에서는 반드시 암호화 옵션을 활성화하세요.
  • 암호화 전송: AES-256을 통한 응답 데이터 암호화
  • 접근 제어: API 키를 통한 프로젝트별 접근 제한
  • 사전 검증: 옵션 활성화 여부와 관계없이 API 조회 가능

​
토큰 정책

Token Pool: 각 PID별 최대 5,000개 토큰 관리 조회 범위: 프로젝트 범위 내 토큰만 조회 가능

​
에러 코드

​
공통 에러

Error CodeHTTP StatusDescription
invalid_payload400요청 페이로드 누락 또는 형식 오류
invalid_path400지원하지 않는 HTTP 메서드
invalid_project400프로젝트 ID 누락 또는 잘못된 API 키
internal_server_error500서버 내부 오류

​
Token 관련 에러

Error CodeHTTP StatusDescription
token_id_not_found400요청한 토큰이 풀에 존재하지 않음
token_id_details_not_found400토큰 상세 정보 조회 실패
invalid_token_id_format400토큰 ID 형식 규칙 위반

​
사용 예시

1

전체 토큰 목록 확인

먼저 프로젝트에 등록된 모든 토큰을 조회합니다.
curl -X GET 'https://rest-api.argosidentity.com/v3/submission/tokens' \
  -H 'x-api-key: YOUR_API_KEY'
응답에서 count 필드로 총 토큰 수를 확인할 수 있습니다.
2

특정 토큰 상세 조회

특정 토큰의 상세 정보를 조회합니다.
curl -X GET 'https://rest-api.argosidentity.com/v3/submission/tokens?tokenId=user001a' \
  -H 'x-api-key: YOUR_API_KEY'
updateTime을 통해 토큰의 최종 업데이트 시간을 확인할 수 있습니다.
암호화된 환경에서는 응답 데이터 또한 암호화되어 제공됩니다.
해당 데이터에 대한 복호화 처리가 필요합니다.
암호화와 복호화 방법은, 데이터 암호화 및 복호화를 참고하세요.