Todas las guías

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

  1. Ve a Orígenes → Endpoints de API y selecciona Nuevo endpoint de API.
  2. Introduce un Nombre que diga para qué se usa el endpoint, por ejemplo «Facturas del ERP».
  3. 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.
  4. 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 de targets no 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