POST
/api/mod/fuentes/{espacio}/fuentes/{fuente}/lanzarLanza una fuente
Lee las páginas de la fuente y publica lo leído en los documentos del espacio. Si ya hay una corrida en la cola, te devuelve esa.
- PERMISOescribe
- CRÉDITOSgasta créditos
- AUTENTICACIÓNBearer bth_…
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Fuentes. |
| fuente | string | SÍ | El id de la fuente: el que devolvió crearla (32 caracteres hexadecimales). |
RESPUESTA 202
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| run_id | string | La corrida. |
| status | "recibido" | En la cola. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Fuentes | módulo no habilitado para este espacio. |
| 403 | La clave es de solo lectura | Tu cuenta es de solo lectura en este espacio. |
| 402 | La cuenta agotó sus créditos del ciclo | La cuenta de este espacio agotó sus créditos de este ciclo. |
| 404 | No hay una fuente con ese id en el espacio | La fuente no existe |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.
CONVIENE SABER
- Sigue la corrida con GET fuentes/{fuente}: su
estadopasa apublicado,fallidoocancelado.