POST
/api/mod/fuentes/{espacio}/fichasArma una ficha
Le das un tema y una plantilla con los campos que quieres. Bentho busca en la web pública, lee las páginas y llena cada campo con el dato, la página de la que sale y la frase que lo respalda. Al terminar, la ficha se publica en los documentos del espacio.
- 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. |
CUERPO · JSON
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| tema | string | SÍ | De qué trata la ficha, de 2 a 120 caracteres. |
| plantilla | string | SÍ | Los campos, en markdown: ## por sección y una línea - Nombre: qué buscar por campo. Su forma, en la guía. |
| paginas | integer | no | Cuántas páginas leer como mucho, de 1 a 5000. Por defecto 6. |
| urls | string[] | no | Páginas que ya conoces sobre el caso, HTTP o HTTPS. Se leen además de lo que encuentre, y marcan dónde seguir buscando. |
| como | object | no | Cómo buscar: ver como. |
RESPUESTA 202
La ficha recién creada. Guarda su id.
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id | string | El id de la ficha. |
| tema | string | El tema, sin espacios en los extremos. |
| status | "recibido" | En la cola. |
COMO
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| idioma | string | El idioma de la ficha y de la búsqueda. Por defecto "es". |
| dominios | string[] | Lee solo páginas de estos dominios (hasta 50). Vacío: toda la web pública. |
| rondas | integer | Vueltas de búsqueda, de 1 a 8 (por defecto 4). Cada una busca solo los campos que siguen vacíos. |
| paginas_por_ronda | integer | Páginas nuevas que lee cada vuelta, de 1 a 12 (por defecto 4). |
| instrucciones | string | Indicaciones para buscar, hasta 500 caracteres: «solo fuentes oficiales», «precios en pesos colombianos». |
| coherencia | boolean | Una ficha, un caso: descarta los datos de páginas que hablan de otro caso parecido. Por defecto false. |
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 | La plantilla no tiene ninguna sección con campos | La plantilla no tiene secciones con campos |
| 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.
CONVIENE SABER
- Responde enseguida: el trabajo sigue en segundo plano y suele tardar unos minutos. Consulta el estado cada 10 a 15 s.
- Armar otra ficha con el mismo tema la reemplaza en los documentos del espacio: queda una versión nueva del mismo documento.
- Si la web abierta da menos de la mitad de los campos, aportar 2 a 4
urlsconcretas del caso suele subir cuántos se llenan.