Para desarrolladores

Integración API

Automatice la producción de tarjetas desde su sistema. API REST, webhooks, documentación completa.

Acceder a la documentación Hablar con un ingeniero

Integración rápida

Fácil de integrar

Una sola solicitud HTTP basta para activar la impresión, la codificación NFC y el envío de una tarjeta. Webhooks para el seguimiento en tiempo real.

API REST con autenticación por clave API
Webhooks para actualizaciones de estado en tiempo real
Sandbox completo para pruebas sin coste
Documentación OpenAPI (Swagger) completa
Respuestas JSON estandarizadas y paginadas
Idempotencia en las solicitudes de creación

Las mismas operaciones también se pueden dirigir desde un asistente de IA.

Descubrir el servidor MCP de Printags

SDK y CLI de Printags para la API

// Crear un pedido de tarjeta

POST https://api.printags.com/v2/accounts/@me/orders
Authorization: Bearer sk_test_...
Idempotency-Key: order-2026-001

{
  "isDraft": true,
  "reference": "Order-2026-001",
  "shipTo": {
    "name": "Jean Dupont",
    "phone": "+33612345678",
    "email": "[email protected]",
    "address": {
      "addressLine1": "12 rue de la Paix",
      "city": "Paris",
      "postcode": "75002",
      "countryCode": "FR"
    }
  },
  "items": [{
    "productId": "ntag213_pvccard_white",
    "quantity": 10,
    "printingVisuals": ["<fileId>"],
    "nfc": { "type": "uri", "content": "https://example.com/jean" }
  }]
}

Arquitectura

Arquitectura de integración

Su sistema se comunica con la API de Printags. Nosotros nos encargamos del resto.

Su sistema

ERP, CRM, e-commerce, SaaS

API RESTWebhooks

Printags

Impresión + codificación + envío

Referencia API

Endpoints principales

POST/v2/accounts/{accountId}/ordersCrear un pedido, como borrador o en firme (cabecera Idempotency-Key admitida)

GET/v2/accounts/{accountId}/orders/{orderId}Leer un pedido

GET/v2/accounts/{accountId}/ordersListar los pedidos, paginados

POST/v2/accounts/{accountId}/filesSubir un archivo de diseño

GET/v2/productsCatálogo de productos

POST/v2/shipping/ratesPrecios de envío para un destino

POST/v2/accounts/{accountId}/orders/{orderId}/validateValidar un pedido en borrador

GET/v2/statusesEstados de los pedidos

Webhooks

Notificaciones en tiempo real

Reciba notificaciones automáticas cuando cambie un pedido. Configure sus webhooks desde el panel de control.

order.created

Pedido creado

order.updated

Pedido actualizado

order.shipped

Pedido enviado

order.delivered

Entrega confirmada

Sandbox y seguridad

Pruebe con total seguridad

Las claves de prueba (sk_test_...) crean pedidos de prueba que no se cobran ni se fabrican. Use la API de producción con una clave de prueba, o sandbox-api.printags.com, que solo acepta claves de prueba.

Los pedidos de prueba nunca se cobran ni se fabrican
Claves API separadas (prueba / producción)
HTTPS obligatorio en todos los endpoints
Límites de uso anunciados en las cabeceras estándar RateLimit
Logs e historial de todas las solicitudes

Escenarios de integración

Cómo nuestros integradores usan la API

E-commerce

Un cliente pide una tarjeta en su tienda. La API activa automáticamente la producción y el envío.

SaaS / Plataforma

Su plataforma gestiona miembros. Con cada registro, se imprime y envía una tarjeta automáticamente.

RRHH / Corporativo

Nuevo empleado = credencial automática. La API se integra con su SIRH para activar la producción.

IoT / Quioscos

Nuevo suscriptor de su red de quioscos = credencial NFC impresa y enviada automáticamente a través de la API.

Eventos

Inscripciones en línea = credenciales personalizadas producidas y enviadas a los participantes antes del evento.

Programa de fidelización

Nuevo miembro de su programa = tarjeta de fidelización NFC impresa con datos variables y codificación.

Preguntas frecuentes

FAQ — Integración API

¿Cuánto tiempo lleva la integración?

La mayoría de nuestros integradores están operativos en menos de un día. La documentación es completa, con ejemplos de código en varios lenguajes. Un entorno sandbox está disponible de inmediato.

¿Hay SDK disponibles?

Sí: el paquete npm printags (SDK y línea de comandos para Node.js 18 o superior, licencia MIT). La API también es una API REST estándar descrita por un documento OpenAPI, así que cualquier lenguaje puede llamarla. Vea la página SDK y CLI.

¿La API está disponible 24/7?

Sí, la API está disponible las 24 horas del día, los 7 días de la semana. Garantizamos un SLA de 99,9% de disponibilidad. El estado en tiempo real está disponible en nuestra página de estado.

¿Cómo funciona la facturación?

Suscripción mensual + coste unitario por tarjeta, facturados automáticamente a final de mes.

¿Los datos transmitidos están seguros?

Sí. HTTPS obligatorio en todos los endpoints. Los datos personales (fotos, nombres) se cifran en reposo y se eliminan tras la producción. Cumplimiento del RGPD.

¿Hay límites de uso?

Las rutas documentadas permiten 1200 solicitudes por minuto y por clave de API. Cada respuesta incluye las cabeceras RateLimit, y una respuesta 429 incluye Retry-After.

¿Cómo funcionan las versiones de la API?

La versión actual es /v2. La versión 1 (/v1) está obsoleta desde el 25 de octubre de 2026 y se retirará el 4 de enero de 2027: cada respuesta documentada de la versión 1 incluye las cabeceras Deprecation y Sunset y un enlace Link a su equivalente en la versión 2.

¿Listo para integrar?

Cree su cuenta y acceda al sandbox en 2 minutos. Documentación completa disponible.

Crear mi cuenta de integrador Documentación API