Renovamos por dentro os quatro endpoints de conteúdo web sob /global. As rotas, a autenticação e os limites continuam iguais; mudam quatro detalhes do contrato que vale a pena revisar se você já os usa.
Research em poucos segundos#
POST /global/research/v1 agora responde em poucos segundos, e não nos 10 a 30 que anunciamos no lançamento. O formato da resposta não muda: report em markdown com citações numeradas e sources com as páginas que o embasam. pages_analyzed passa a indicar quantas fontes embasam o relatório.
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?" }'Sai o country#
Os endpoints de páginas não aceitam mais country. Se você continuar enviando, ele é ignorado; não há erro para corrigir. A leitura de uma página não depende do país de onde ela é consultada.
effort diz o que faz#
| Valor | O que você recebe |
|---|---|
min | A resposta mais rápida; pode vir de uma cópia recente da página. |
standard | O equilíbrio padrão. |
max | Sempre lê a página ao vivo, inclusive as que são montadas no navegador. |
Metadados mais honestos#
Com include_metadata: true, metadata traz title, author, published_at e image. Um campo que a página não declara chega como null. Os campos que quase nunca conseguíamos preencher (descrição, nome do site, palavras-chave, número de páginas) saem do contrato.
404 quando não há nada para ler#
POST /global/extract/json/v1 e POST /global/generate/json/v1 agora respondem 404 quando a página não tem conteúdo legível, assim como extract/markdown, em vez de devolver um objeto vazio. A mensagem indica qual opção mudar.