Renovamos por dentro los cuatro endpoints de contenido web bajo /global. Las rutas, la autenticación y los límites siguen iguales; cambian cuatro detalles del contrato que conviene revisar si ya los usas.
Research en unos segundos#
POST /global/research/v1 ahora responde en unos pocos segundos, no en los 10 a 30 que anunciamos al lanzarlo. La forma de la respuesta no cambia: report en markdown con citas numeradas y sources con las páginas que lo respaldan. pages_analyzed pasa a indicar cuántas fuentes respaldan el informe.
curl https://api.croma.run/global/research/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "¿Qué cambios trajo la Ley 2195 de 2022 en materia de responsabilidad de personas jurídicas en Colombia?" }'Desaparece country#
Los endpoints de páginas ya no aceptan country. Si lo sigues enviando, se ignora; no hay error que corregir. La lectura de una página no depende del país desde donde se consulta.
effort dice lo que hace#
| Valor | Qué obtienes |
|---|---|
min | La respuesta más rápida; puede venir de una copia reciente de la página. |
standard | El balance por defecto. |
max | Siempre lee la página en vivo, incluidas las que se construyen en el navegador. |
Metadatos más honestos#
Con include_metadata: true, metadata trae title, author, published_at e image. Un campo que la página no declara llega como null. Los campos que casi nunca podíamos llenar (descripción, nombre del sitio, palabras clave, número de páginas) salen del contrato.
404 cuando no hay nada que leer#
POST /global/extract/json/v1 y POST /global/generate/json/v1 ahora responden 404 cuando la página no tiene contenido legible, igual que extract/markdown, en lugar de devolver un objeto vacío. El mensaje indica qué opción cambiar.