Saltar al contenido

API pseudonymize.io

Bienvenido a la documentación de pseudonymize.io. Coloque esta API en el camino de sus datos confidenciales antes de que lleguen a sistemas externos (como LLM, almacenes de análisis o herramientas de soporte de terceros).

Inicio rápido

Envíe una solicitud a Text API para seudonimizar la prosa.

curl -X POST https://api.pseudonymize.io/text \
  -H "Authorization: Bearer ps_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Alice Rossi disputed invoice INV-204 from [email protected]",
    "policy": "default"
  }'

Respuesta:

{
  "text": "PERSON_01 disputed invoice INV-204 from EMAIL_01",
  "entities": [
    { "type": "PERSON", "original": "Alice Rossi", "pseudonym": "PERSON_01" },
    { "type": "EMAIL", "original": "[email protected]", "pseudonym": "EMAIL_01" }
  ]
}

Autenticación

Todas las solicitudes de API deben incluir su clave API en el encabezado "Autorización".

Authorization: Bearer ps_live_...

Las claves API se generan en el formato ps_live_.... Para su seguridad, la clave secreta completa se muestra sólo una vez al momento de su creación. pseudonymize.io nunca almacena claves API en texto sin formato; solo se conservan un hash criptográfico no reversible (SHA-256) y un prefijo de identificación corto (ps_live_XXXX).

Puede administrar sus claves API en el Panel.

API de texto

POST https://api.pseudonymize.io/text (también disponible a través de POST https://api.pseudonymize.io/v1/text y /api/v1/text)

Reemplaza identificadores dentro de la prosa sin aplanar el texto que los rodea.

Cuerpo de solicitud

  • text (cadena, requerido): El texto a procesar.
  • policy (cadena, opcional): La política a utilizar. El valor predeterminado es "predeterminado".
  • detectar (matriz, opcional): tipos de entidades específicas para detectar.
{
  "text": "Call me at +39 333 1234567.",
  "detect": ["PHONE"]
}

API de datos estructurados

POST /api/v1/datos

Utilice seudónimos para los campos de identificador manteniendo las filas y los esquemas utilizables.

Cuerpo de solicitud

  • payload (objeto | matriz, requerido): La estructura JSON a procesar (también se puede pasar como datos).
  • policy (cadena, opcional): La política a utilizar. El valor predeterminado es "predeterminado".
  • detectar (matriz, opcional): tipos de entidades específicas para detectar.
{
  "payload": {
    "user": {
      "name": "Mario Rossi",
      "email": "[email protected]"
    }
  },
  "detect": ["PERSON", "EMAIL"]
}

Reserva de facturación y crédito

Pseudonymize.io opera con un modelo transparente de pago por uso:

  • 1 € por millón de tokens medidos. Cada solicitud exitosa se redondea hacia arriba en bloques de 1.000 tokens (1 crédito), con un cargo mínimo de 0,001 €.
  • Reserva previa al vuelo: los créditos se reservan atómicamente en el límite de la puerta de enlace antes de que las cargas útiles lleguen al motor central. Si una cuenta no tiene créditos suficientes, la API devuelve "Pago 402 requerido" inmediatamente sin reenviar los datos del cliente.
  • Garantía de reembolso automatizado: si una llamada de procesamiento central ascendente falla o se agota el tiempo de espera, los créditos reservados se reembolsan inmediatamente en su totalidad.

Seudónimos e identidad determinista

Pseudonymize.io utiliza preservación de identidad determinista dentro de una sola solicitud. Si "Alice" aparece tres veces en el mismo documento, se convierte en "PERSON_01" las tres veces. Esto permite a los LLM comprender que es la misma persona sin saber quién es.

Errores y límites

Usamos códigos de estado HTTP estándar.

  • 200 OK: Procesamiento exitoso.
  • 400 Bad Request: formato de carga útil no válido o faltante, o profundidad de datos estructurados que excede los 32 niveles.
  • 401 No autorizado: clave API faltante, no válida o inactiva.
  • 402 Pago requerido: Créditos restantes insuficientes. Bloqueado en el límite de la puerta de enlace.
  • 413 Carga útil demasiado grande: el cuerpo de la solicitud supera los 10 MB o el recuento total de elementos estructurados supera las 50 000 claves.
  • 429 Demasiadas solicitudes: límite de velocidad excedido (60 solicitudes/min por clave API, 120 solicitudes/min por cuenta e IP). El encabezado "Retry-After" indica cuándo volver a intentarlo.
  • 502 Bad Gateway: motor central inalcanzable o falla en el procesamiento de backend. Los créditos se reembolsan automáticamente.
  • 504 Gateway Timeout: el motor central no respondió en 30 segundos. Los créditos se reembolsan automáticamente.

Entidades admitidas

  • PERSONA (Nombres)
  • ORGANIZACIÓN (Nombres de empresas)
  • EMAIL (Direcciones de correo electrónico)
  • TELÉFONO (Números de teléfono)
  • UBICACIÓN (Ciudades, direcciones)
  • IP (IPv4 e IPv6)
  • IBAN (Cuentas bancarias) *TARJETA (Tarjetas de crédito/débito)

Seguridad

  • Las tablas de facturación de puerta de enlace y las métricas de solicitudes estructuradas excluyen los cuerpos de solicitud y respuesta de API. Los metadatos de cuenta, autenticación, uso, reserva y pago se conservan por separado; La eliminación de una cuenta no elimina todos los registros o copias de seguridad.
  • Las respuestas exitosas con un Idempotency-Key se retienen en la memoria del proceso durante una ventana de reproducción de cinco minutos. Los detalles de la entidad pueden contener identificadores originales. Los controles de motor, proxy, intercambio, volcado de emergencia y copia de seguridad requieren una verificación por separado; La persistencia cero del disco no está garantizada en toda la cadena de procesamiento.
  • Consulte la Política de privacidad y la página de Seguridad para conocer los límites de manejo y eliminación.