Skip to main content
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

string
requerido
POST

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

string
requerido
Establezca su clave API del proyecto.
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.

Parámetros de Solicitud

Cuerpo de la Solicitud

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

Respuesta

Respuesta Exitosa (200)

Boolean
Estado de éxito de la operación
String
Mensaje de resultado de la operación
Object
Información de resumen
Object
Información detallada (incluida solo cuando ocurren fallos)

Respuesta de Error (400/500)

String
requerido
Código de error
String
requerido
Mensaje de error
Object
Detalles del error (opcional)

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

Errores Relacionados con Tokens

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.
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.