Descargar un entregable
get /v1/artifacts/{artifact_id}/download
Descarga el documento de un run —el PDF, el JSON o la captura—. El enlace ya viene armado en document.download_url de la respuesta del run y en el webhook.
No lleva API key: se autentica con el
token de la URL, firmado y de expiración corta. Por eso el enlace se puede abrir directo desde tu backend.Pasado el
expires_at del documento el enlace deja de servir: vuelve a pedir el run para obtener uno nuevo.Autenticación
Requiere API key (sk_live_… · sk_test_…) en la cabecera
authorization: Bearer …. Ver autenticación.
Parámetros
| Nombre | En | Tipo | Descripción |
|---|---|---|---|
artifact_idobligatorio | path | string | — |
tokenobligatorio | query | string | Token de descarga firmado, el de `download_url`. |
Errores
| Código | Cuándo |
|---|---|
403 | Token ausente o inválido |
404 | No existe o ya expiró |
El cuerpo de cualquier error sigue la misma forma y su code viene de un
catálogo cerrado. Ver errores.