--- title: "API de Printags: documentación REST, OpenAPI, SDK y CLI | Printags" description: "API REST de Printags (OpenAPI): cree y siga pedidos de tarjetas PVC y NFC, pruebe con claves de sandbox, use el SDK y la CLI de npm o el servidor MCP." canonical: "https://www.printags.com/es/integracion-api/" --- # Integración API Automatice la producción de tarjetas desde su sistema. API REST, webhooks, documentación completa. [Acceder a la documentación](https://docs.printags.com)[Hablar con un ingeniero](https://app.monagence.pro/book/printags/decouvrir-printags) 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](https://www.printags.com/es/servidor-mcp/) [SDK y CLI de Printags para la API](https://www.printags.com/es/sdk-y-cli/) // 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": "jean@example.com", "address": { "addressLine1": "12 rue de la Paix", "city": "Paris", "postcode": "75002", "countryCode": "FR" } }, "items": [{ "productId": "ntag213_pvccard_white", "quantity": 10, "printingVisuals": [""], "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}/orders`Crear un pedido, como borrador o en firme (cabecera Idempotency-Key admitida) GET`/v2/accounts/{accountId}/orders/{orderId}`Leer un pedido GET`/v2/accounts/{accountId}/orders`Listar los pedidos, paginados POST`/v2/accounts/{accountId}/files`Subir un archivo de diseño GET`/v2/products`Catálogo de productos POST`/v2/shipping/rates`Precios de envío para un destino POST`/v2/accounts/{accountId}/orders/{orderId}/validate`Validar un pedido en borrador GET`/v2/statuses`Estados 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](https://dashboard.printags.com/register)[Documentación API](https://docs.printags.com)