Equipo y administración
Endpoints de API
Deja que programas, scripts y automatizaciones envíen documentos a una URL secreta y los impriman.
Un endpoint de API es una URL secreta a la que los programas envían documentos, por ejemplo facturas de un ERP, etiquetas de una tienda online o informes de un script. Cada documento se convierte en un trabajo en nombre de la persona que creó el endpoint y va a su destino. La propia URL es la clave de acceso, así que no hace falta un token de API. La referencia de la API describe cada opción.
Requisitos
- El canal de entrada REST API debe estar activado en Ajustes → Canales de entrada. En las organizaciones nuevas está activado; en las más antiguas puede que un administrador tenga que activarlo.
- Cada miembro puede crear endpoints de API. Los usuarios ven los suyos, los administradores todos los de la organización.
- Incluido en todos los planes.
Configuración inicial
- Ve a Orígenes → Endpoints de API y selecciona Nuevo endpoint de API.
- Introduce un Nombre que diga para qué se usa el endpoint, por ejemplo «Facturas del ERP».
- Elige la Ruta de los documentos cuya solicitud no indica ninguna: un destino, grupo o flujo de trabajo, Ruta predeterminada (la del propietario) o Sin ruta – guardar en Sealed Print.
- Selecciona Crear y copia la URL del endpoint en tu programa.
Envía el documento como cuerpo de la solicitud con el Content-Type adecuado:
curl -X POST "https://www.sealedprint.com/api/print/sp_ep_…?name=Invoice" \
-H "Content-Type: application/pdf" \
--data-binary @invoice.pdf
O como formulario con el campo file; las opciones van como campos del formulario:
curl -X POST "https://www.sealedprint.com/api/print/sp_ep_…" \
-F "file=@invoice.pdf" \
-F "name=Invoice" \
-F "copies=2"
targets envía una solicitud a otro sitio por identificador: los identificadores de destinos, grupos o un flujo de
trabajo, separados por comas, por ejemplo targets=office,warehouse (un flujo de trabajo va primero).
destinationId, destinationIds, groupId o workflowId hacen lo mismo por ID, y noTarget=true (o
targets=hold) guarda el documento en Sealed Print. Sustituyen la ruta del endpoint en una solicitud; las opciones de
impresión como copies o sides van como parámetros de consulta o campos del formulario. La respuesta es el trabajo
(HTTP 201).
Cada vez
- Último uso en el endpoint muestra si un programa sigue enviando documentos.
- Editar cambia el nombre y la ruta; la URL no cambia.
- Generar nueva URL sustituye la URL; la antigua deja de funcionar de inmediato. Eliminar termina el endpoint para siempre.
- Para seguir el estado de un trabajo desde tu programa, usa un token de API.
Solución de problemas
- HTTP 403: el canal de entrada REST API está desactivado, o la persona que creó el endpoint dejó la organización. Crea un nuevo endpoint con otro miembro.
- HTTP 404: la URL es incorrecta o se sustituyó por una nueva. Con el código
unknown_target, un identificador detargetsno existe o pertenece a un destino al que el propietario del endpoint no puede imprimir. - HTTP 413 o 415: el archivo supera lo que permite el plan, o no es un PDF, JPEG o PNG.
- La URL se copió donde no debía: selecciona Generar nueva URL de inmediato.
Siguientes pasos
- Referencia de la API: cada endpoint, con la descripción OpenAPI.
- Tokens de API
- Canales de entrada y de salida
- Imprimir documentos de Stripe: facturas, notas de crédito y presupuestos de Stripe a través de un endpoint de API.