POST
/api/mod/fuentes/{espacio}/fuentesCrea una fuente
Una fuente son páginas o dominios que Bentho lee y publica en los documentos del espacio cada vez que la lanzas. Crearla no la lee: para eso, lánzala.
- PERMISOescribe
- CRÉDITOSno gasta
- 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. |
CUERPO · JSON
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| nombre | string | SÍ | Para reconocerla, de 1 a 160 caracteres. |
| tema | string | no | De qué tratan las páginas, hasta 400 caracteres. |
| urls | string[] | UNA DE LAS DOS | Las páginas que se leen, hasta 50. |
| dominios | string[] | UNA DE LAS DOS | Dominios que se recorren, hasta 50. |
| campos | [{ nombre, descripcion }] | no | Hasta 20 datos que sacar de cada página. nombre: letras, números, _ y espacios, hasta 80; descripcion, hasta 400. |
| limites | { paginas, profundidad } | no | Páginas como mucho, de 1 a 50 (por defecto 20), y cuántos enlaces seguir desde cada una, 1 o 2 (por defecto 1). |
RESPUESTA 201
La fuente, con estado lista.
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id · nombre · tema | string | Los que diste al crearla. |
| urls · dominios | string[] | Los tuyos. |
| campos · limites | array · object | También los tuyos (limites, con sus valores por defecto). |
| estado | string | El de la última corrida, o lista si nunca se lanzó: ver estados. |
| paginas | integer | Páginas publicadas en la última corrida. |
| error | string | Por qué falló. Vacío si no falló. |
| run_id | string | null | La última corrida; null si ninguna. |
| actualizado | number | Segundos desde 1970, con decimales. |
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. |
| 422 | Sin urls ni dominios | La fuente necesita URLs o dominios |
| 422 | Un campo fuera de su rango o de su tipo (detail es una lista) | — |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.