DELETE/Token

Elimine de forma segura los tokens registrados. Puede eliminar hasta 5,000 tokens en lote, con soporte de procesamiento parcial.

La eliminación de tokens es una operación irreversible. Por favor revise cuidadosamente antes de eliminar.

Información Básica

method

string

requerido

DELETE

url

string

requerido

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

Configuración de Seguridad

Transmisión Cifrada

Cuando la opción Secure Data Transmission está habilitada, las solicitudes y respuestas se cifran con AES-256.

Método de cifrado: AES-256
Cobertura: Datos de solicitud y respuesta
Compatibilidad: Mismo método de cifrado/descifrado que POST/submission, PATCH/submission, GET/submission
Opciones de Transferencia Segura de Datos

Seguridad de Datos

Los datos de tokens eliminados se remueven completamente y no pueden ser recuperados. En la transmisión segura de datos, el proceso de eliminación también procede con cifrado.

Autenticación

x-api-key

string

requerido

Establezca su clave API del proyecto.

Content-Type

string

Establezca el tipo MIME del cuerpo de la solicitud.

Cuando use Content-Type: application/json para solicitudes DELETE, si ocurre un error, use text/plain en su lugar.

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

Tipos de Eliminación de Tokens

Eliminación por tokenId especificado

Eliminar tokenId específico (máximo 500 por solicitud)

Eliminación de N basada en tiempo

Eliminar N tokens basado en orden de envío y conteo (máximo 5,000 por solicitud)

Parámetros de Solicitud

Cuerpo de la Solicitud

Eliminación por tokenId especificado
Eliminación de N tokens basada en tiempo

tokenId

Array<String>

requerido

Array de IDs de tokens a eliminar (máximo 500)Formato del ID de token:

Longitud: 8 Byte ~ 64 Byte
Caracteres permitidos: Letras (a-z, A-Z), números (0-9), guiones (-), guiones bajos (_), puntos (.)
Restricciones: Sin espacios, tabulaciones ni caracteres de nueva línea
Inicio/Fin: Debe comenzar y terminar solo con letras o números

count

Number

requerido

Número de tokens a eliminar (máximo 5000)

order

string

requerido

asc: Orden ascendente
desc: Orden descendente

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"
  ]
}'

Respuesta

Respuesta Exitosa (200)

Eliminación por tokenId especificado
Eliminación de N tokens basada en tiempo

success

Boolean

requerido

Estado de éxito de la operación

message

String

requerido

Mensaje de resultado de la operación

summary

Object

requerido

Información de resumen

Mostrar summary properties

totalSubmitted

Number

Número total de tokens enviados

deleted

Number

Número de tokens eliminados exitosamente

notFound

Number

Número de tokens inexistentes

failed

Number

Número de tokens que fallaron al eliminar

details

Object

Información detallada (incluida solo cuando hay fallos o tokens inexistentes)

Mostrar details properties

notFound

Array<String>

Lista de tokens inexistentes

failed

Array<Object>

Lista de tokens que fallaron al eliminar

Mostrar failed array properties

tokenId

String

ID del token que falló al eliminar

error

String

Código de fallo de eliminación

message

String

Mensaje de fallo de eliminación

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

Respuesta de Error (400/500)

errorCode

String

requerido

Código de error

errorMessage

String

requerido

Mensaje de error

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

Política de Tokens

Limitaciones

Límite de solicitud: Máximo 5,000 IDs de tokens por solicitud Límite del pool: Máximo 100,000 tokens gestionados por PID

Manejo Parcial

Las solicitudes DELETE se procesan parcialmente para los IDs de tokens. Los IDs de tokens que no existen en el pool se indican en el campo ‘notFound’ de la respuesta, y solo se eliminan los IDs de tokens existentes.

Ejemplo:

IDs de tokens existentes en el pool: tokenA, tokenB, tokenC
Solicitud DELETE: tokenA, tokenC, tokenD
Pool después de completar la solicitud: tokenB
Respuesta details.notFound: [tokenD]

Consideraciones de Seguridad

Eliminación Completa de Datos

Los tokens eliminados en modo privado se remueven completamente en estado cifrado y no pueden ser recuperados.

Eliminación segura: Remoción completa de la base de datos
Procesamiento de cifrado: Cifrado AES-256/GCM-256 aplicado al proceso de eliminación también
Registros de auditoría: Registros de operaciones de eliminación mantenidos (excluyendo contenido de tokens)

Control de Acceso

Los permisos de eliminación se controlan a través de claves API. Se requiere especial cuidado en la gestión de claves API.

Códigos de Error

Errores Comunes

Error Code	HTTP Status	Descripción
invalid_payload	400	Payload de solicitud faltante o error de formato
invalid_path	400	Método HTTP no soportado
invalid_project	400	ID de proyecto faltante o clave API inválida
invalid_query_parameters	400	Parámetros de consulta faltantes o error de formato
invalid_order	400	Error de formato en el parámetro de orden de consulta
internal_server_error	500	Error interno del servidor

Errores Relacionados con Tokens

Error Code	HTTP Status	Descripción
invalid_token_id	400	ID de token faltante, valor vacío o no es un array
invalid_token_id_format	400	Violación de regla de formato de ID de token
invalid_token_id_type	400	El ID de token no es una cadena
invalid_token_id_length	400	Longitud del ID de token fuera del rango de 8-64 caracteres
invalid_token_id_whitespace	400	El ID de token contiene caracteres de espacio en blanco
invalid_token_id_characters	400	El ID de token contiene caracteres no permitidos
invalid_token_id_start	400	El ID de token no comienza con letra/número
invalid_token_id_end	400	El ID de token no termina con letra/número
request_token_limit_exceeded	400	Límite de conteo de tokens por solicitud excedido (500)
token_limit_exceeded	400	Limite total de tokens del proyecto excedido (100,000)
token_id_not_found	400	El token solicitado no existe en el pool
token_id_details_not_found	400	Fallo en la recuperación de detalles del token
delete_token_limit_exceeded	400	Conteo de solicitud de eliminación masiva basada en tiempo excedido (5000)

Ejemplos de Uso

Verificar tokens a eliminar

Verifique si los tokens existen antes de eliminarlos.

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

Si el token existe, se devolverá información detallada.

Ejecutar eliminación de tokens

Elimine los tokens verificados. Tipos: eliminación por token especificado, eliminación de tokens basada en tiempo

Mostrar Eliminación por token especificado

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"]}' 

Mostrar Eliminación de tokens basada en tiempo

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"}' 

La eliminación se ejecuta inmediatamente y no se puede deshacer.

Verificar resultados de eliminación

Verifique los resultados de la eliminación en la respuesta.

Puede verificar el número de tokens eliminados exitosamente en el campo summary.deleted.

Durante la eliminación masiva, incluso si se incluyen tokens inexistentes, solo se eliminan selectivamente los tokens existentes. Puede verificar la lista de tokens inexistentes en details.notFound.

Aviso de Content-Type: Para solicitudes DELETE, cuando usar Content-Type: application/json causa un error, establezca el encabezado a text/plain en su lugar.

Descripción General

Referencia API

Información Básica

Configuración de Seguridad

Transmisión Cifrada

Seguridad de Datos

Autenticación

Tipos de Eliminación de Tokens

Parámetros de Solicitud

Cuerpo de la Solicitud

Respuesta

Respuesta Exitosa (200)

Respuesta de Error (400/500)

Política de Tokens

Limitaciones

Manejo Parcial

Consideraciones de Seguridad

Eliminación Completa de Datos

Control de Acceso

Códigos de Error

Errores Comunes

Errores Relacionados con Tokens

Ejemplos de Uso

Descripción General

Referencia API

​Información Básica

​Configuración de Seguridad

​Transmisión Cifrada

​Seguridad de Datos

​Autenticación

​Tipos de Eliminación de Tokens

​Parámetros de Solicitud

​Cuerpo de la Solicitud

​Respuesta

​Respuesta Exitosa (200)

​Respuesta de Error (400/500)

​Política de Tokens

​Limitaciones

​Manejo Parcial

​Consideraciones de Seguridad

​Eliminación Completa de Datos

​Control de Acceso

​Códigos de Error

​Errores Comunes

​Errores Relacionados con Tokens

​Ejemplos de Uso

Información Básica

Configuración de Seguridad

Transmisión Cifrada

Seguridad de Datos

Autenticación

Tipos de Eliminación de Tokens

Parámetros de Solicitud

Cuerpo de la Solicitud

Respuesta

Respuesta Exitosa (200)

Respuesta de Error (400/500)

Política de Tokens

Limitaciones

Manejo Parcial

Consideraciones de Seguridad

Eliminación Completa de Datos

Control de Acceso

Códigos de Error

Errores Comunes

Errores Relacionados con Tokens

Ejemplos de Uso