Saltar al contenido principal
Registre tokens de forma segura. Puede registrar hasta 100,000 tokens por proyecto, con un máximo de 500 tokens por solicitud.
Puede transmitir datos de forma segura a través de las funciones de seguridad de modo privado y cifrado.

​
Información Básica

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

​
Configuración de Seguridad

​
Opción de Cifrado

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

​
Autenticación

​
x-api-key
string
requerido
Establezca su clave API del proyecto.
​
Content-Type
string
requerido
Establezca el tipo MIME del cuerpo de la solicitud.
Cuando use Content-Type: application/json para solicitudes POST, si la solicitud falla, use text/plain en su lugar.
x-api-key: {{YOUR_API_KEY}}
Content-Type: text/plain

​
Parámetros de Solicitud

​
Cuerpo de la Solicitud

​
tokenId
Array<String>
requerido
Array de IDs de tokens a agregar (máximo 500 por solicitud)Restricciones de 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
curl -X POST '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)

​
success
Boolean
Estado de éxito de la operación
​
message
String
Mensaje de resultado de la operación
​
summary
Object
Información de resumen
​
details
Object
Información detallada (incluida solo cuando ocurren fallos)
{
  "success": true,
  "message": "All tokens are now in the pool",
  "summary": {
    "totalSubmitted": 4,
    "currentCount" : 3504,
    "processed": 4,
    "failed": 0
  }
}

​
Respuesta de Error (400/500)

​
errorCode
String
requerido
Código de error
​
errorMessage
String
requerido
Mensaje de error
​
errorDetails
Object
Detalles del error (opcional)
{
  "errorCode": "invalid_token_id_format",
  "errorMessage": "One or more token IDs do not meet the required format specifications.",
  "errorDetails": {
    "invalidTokens": [
      {
        "tokenId": "short01",
        "errorCode": "invalid_token_id_length",
        "errorMessage": "Token ID length must be between 8 and 64 characters. Please adjust the token length."
      }
    ]
  }
}

​
Política de Tokens

​
Limitaciones

Pool de Tokens: Máximo 100,000 por PID (ocurre un error cuando se excede) Por Solicitud: Máximo 500 IDs de tokens
Importante: Ocurrirá un error cuando el pool de tokens supere 100,000. Para gestionar el conteo de tokens, puede utilizar los siguientes dos métodos:
  • Use la API de Eliminación de Tokens DELETE para limpiar tokens innecesarios con anticipación.
  • Habilite la configuración ‘Token Id deletion condition setting’ en la configuración de modo privado del dashboard para eliminación automática cuando los tokens expiren; los tokens usados se eliminan automáticamente.

​
Manejo Parcial

Las solicitudes POST se procesan parcialmente para los IDs de tokens. Los IDs de tokens que ya existen en el pool se sobrescriben, y no se devuelve un error de duplicación separado.
Ejemplo:
  • IDs de tokens existentes en el pool: tokenA, tokenB, tokenC
  • Solicitud POST: tokenA, tokenC, tokenD
  • Pool después de completar la solicitud: tokenA, tokenB, tokenC, tokenD

​
Códigos de Error

​
Errores Comunes

Error CodeHTTP StatusDescripción
invalid_payload400Payload de solicitud faltante o error de formato
invalid_path400Método HTTP no soportado
invalid_project400ID de proyecto faltante o clave API inválida
invalid_query_parameters400Parámetros de consulta faltantes o error de formato
invalid_order400Error de formato en el parámetro de orden de consulta
internal_server_error500Error interno del servidor

​
Errores Relacionados con Tokens

Error CodeHTTP StatusDescripción
invalid_token_id400ID de token faltante, valor vacío o no es un array
invalid_token_id_format400Violación de regla de formato de ID de token
invalid_token_id_type400El ID de token no es una cadena
invalid_token_id_length400Longitud del ID de token fuera del rango de 8-64 caracteres
invalid_token_id_whitespace400El ID de token contiene caracteres de espacio en blanco
invalid_token_id_characters400El ID de token contiene caracteres no permitidos
invalid_token_id_start400El ID de token no comienza con letra/número
invalid_token_id_end400El ID de token no termina con letra/número
request_token_limit_exceeded400Límite de conteo de tokens por solicitud excedido (500)
token_limit_exceeded400Limite total de tokens del proyecto excedido (100,000)
token_id_not_found400El token solicitado no existe en el pool
token_id_details_not_found400Fallo en la recuperación de detalles del token
delete_token_limit_exceeded400Conteo de solicitud de eliminación masiva basada en tiempo excedido (5000)
Puede transmitir de forma segura datos sensibles de tokens a través de la configuración de cifrado. Considere habilitar la opción de cifrado para seguridad en entornos de producción.
Uso de Liveform QueryString: https://form.argosidentity.com?pid={projectid}&token={tokenid_POSTed}
Aviso de Content-Type: Para solicitudes POST, cuando usar Content-Type: application/json causa un error, establezca el encabezado a text/plain en su lugar.