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

// Crear un pedido de tarjeta

POST https://api.printags.com/v1/orders

{
  "card_type": "ntag213",
  "design": {
    "template_id": "tpl_abc123",
    "variables": {
      "name": "Jean Dupont",
      "title": "Directeur technique",
      "photo": "https://..."
    }
  },
  "nfc": {
    "url": "https://example.com/jean"
  },
  "shipping": {
    "name": "Jean Dupont",
    "address": "12 rue de la Paix",
    "city": "Paris",
    "country": "FR"
  }
}

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/v1/ordersCrear un pedido

GET/v1/orders/:idEstado de un pedido

GET/v1/orders/:id/trackingSeguimiento de envío

POST/v1/designsSubir un diseño

GET/v1/templatesListar plantillas

POST/v1/webhooksConfigurar un webhook

GET/v1/cards/:idDetalles de una tarjeta

GET/v1/billing/usageConsumo mensual

Webhooks

Notificaciones en tiempo real

Reciba notificaciones automáticas en cada cambio de estado. Configure sus webhooks a través de la API o el panel de control.

order.created

Pedido recibido y validado

order.printing

Impresión en curso

order.encoding

Codificación NFC en curso

order.quality_check

Control de calidad superado

order.shipped

Paquete enviado, número de seguimiento disponible

order.delivered

Entrega confirmada

Sandbox y seguridad

Pruebe con total seguridad

El entorno sandbox replica la API de producción. Pruebe su integración sin coste y sin riesgo.

Sandbox idéntico a producción
Claves API separadas (prueba / producción)
HTTPS obligatorio en todos los endpoints
Rate limiting configurable
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 SDKs disponibles?

La API es una REST API estándar (JSON sobre HTTPS). Es compatible con todos los lenguajes y frameworks. Proporcionamos ejemplos de código y colecciones Postman para empezar rápidamente.

¿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. El endpoint /v1/billing/usage le permite seguir su consumo en tiempo real. Facturación automática a fin 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.

¿Puedo limitar las llamadas API de mis usuarios?

Sí, el rate limiting es configurable. Por defecto, 100 solicitudes por minuto. Ajustable según su plan.

¿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