La línea de producción, programable

1 · Pide un lugar de subida

curl -X POST https://origami.publica.la/api/v1/uploads \
  -H "Authorization: Bearer ${ORIGAMI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"original_filename": "book.epub", "size_bytes": 4180294}'

Responde 201 con un publication_id, la key de storage, la upload_url a la que hacer PUT, los headers con los que se firmó esa URL, y su expires_at — 30 minutos después.

2 · PUT de los bytes a la URL prefirmada

curl -X PUT "UPLOAD_URL_FROM_STEP_1" \
  -H "Content-Type: application/epub+zip" \
  --data-binary @book.epub

Manda cada header que devolvió el paso anterior, tal cual. La subida va directo al storage: los bytes nunca pasan por la API, así que un libro de 2 GB sube a la velocidad del bucket y no a la de un request de PHP.

3 · Registra la publicación

curl -X POST https://origami.publica.la/api/v1/publications \
  -H "Authorization: Bearer ${ORIGAMI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"publication_id": "ID_FROM_STEP_1", "key": "KEY_FROM_STEP_1", "original_filename": "book.epub", "size_bytes": 4180294}'

Devuelve el mismo publication_id, key, original_filename y size_bytes. El tamaño se compara con lo que realmente llegó, así que una subida truncada se rechaza aquí y no se descubre en la primera ejecución.

4 · Corre una herramienta

curl -X POST https://origami.publica.la/api/v1/publications/PUBLICATION_ID/runs \
  -H "Authorization: Bearer ${ORIGAMI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"tool": "epub-check"}'

Responde 202 con un run. Un run siempre actúa sobre la versión de trabajo de la publicación — el archivo más nuevo que produjo una herramienta, o el original si no hay ninguno.

5 · Consulta el run y lee el reporte

curl https://origami.publica.la/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer ${ORIGAMI_API_KEY}"

curl https://origami.publica.la/api/v1/runs/RUN_ID/report \
  -H "Authorization: Bearer ${ORIGAMI_API_KEY}"

Consulta hasta que status sea terminal. El endpoint de reporte responde 409 run_not_finished mientras el run sigue corriendo, así que consultar primero el run es el ciclo más económico.

6 · Descarga la versión de trabajo

curl https://origami.publica.la/api/v1/publications/PUBLICATION_ID/files/current \
  -H "Authorization: Bearer ${ORIGAMI_API_KEY}"

curl -L -o book-improved.epub \
  https://origami.publica.la/api/v1/files/FILE_ID/download \
  -H "Authorization: Bearer ${ORIGAMI_API_KEY}"

El endpoint de descarga responde un 302 a un GET prefirmado válido por 10 minutos. Sigue los redirects (curl -L) y no guardes en caché el destino.