Resposta rápida
Como verifico se o LLMWebSearch está funcionando?
Chame GET https://llmwebsearch.com/api/v1/credits com a sua chave. É gratuito, não acessa nenhum site, e uma resposta JSON normal prova que a API LLMWebSearch, a sua chave e a sua conta funcionam. Depois faça uma pesquisa, que custa 1 crédito de um pacote a partir de US$ 1,20/1K pesquisas. Erros do nosso lado nunca são cobrados, e os incidentes têm data no changelog.
Qual é a verificação de integridade mais rápida?
O endpoint de créditos. Ele responde apenas do nosso lado: autenticação, a API e a sua conta. Se ele retornar seus créditos restantes, o serviço está no ar para você. Se retornar 401, a chave está errada ou foi revogada; crie uma nova no dashboard.
curl -s https://llmwebsearch.com/api/v1/credits \
-H "Authorization: Bearer $LLMWEBSEARCH_API_KEY"
import os
import sys
import requests
resp = requests.get(
"https://llmwebsearch.com/api/v1/credits",
headers={"Authorization": f"Bearer {os.environ['LLMWEBSEARCH_API_KEY']}"},
timeout=10,
)
if resp.status_code != 200:
print("API check failed:", resp.status_code, resp.text[:200])
sys.exit(1)
print("API up, credits left:", resp.json()["credits_remaining"])
Como distingo nosso erro da recusa de um site?
Veja onde o problema aparece na resposta.
- Um erro HTTP na chamada inteira (
502 search_failed,504 search_timeout) é do nosso lado ou do upstream. Não custa nada; espere um pouco e tente de novo com um atraso crescente. - Uma chamada bem-sucedida com alguns resultados sem conteúdo diz respeito a essas páginas. Cada resultado traz um
content_status:blocked_by_robots,blocked_by_site_policy,target_refused,fetch_failedoufetch_timeout. A pesquisa em si funcionou.
O segundo caso é normal na web aberta e não é um incidente. A página de erros lista todos os códigos.
Onde os incidentes são registrados?
No changelog. Um incidente que afeta muitas contas recebe uma entrada com data: o que falhou, de quando até quando e o que mudou depois. Chamadas que falharam durante um incidente não foram cobradas, então não há nada a reclamar.
Não publicamos porcentagem de uptime nem números de latência. Preferimos dar a você uma verificação que pode executar em vez de um número que você não pode conferir.
O que meu agente deve fazer quando uma chamada falha?
Tente de novo apenas o que pode dar certo mais tarde. Um 429 rate_limited, 502 search_failed ou 504 search_timeout merece uma nova tentativa após uma breve espera que dobra a cada vez. Um 401 ou 402 precisa de uma pessoa: uma nova chave ou mais créditos. Uma página recusada pelo site não deve ser tentada de novo de jeito nenhum; use os outros resultados da mesma pesquisa.
Dúvidas sobre status
A chamada de créditos consome algum crédito?
Não. GET https://llmwebsearch.com/api/v1/credits é gratuito, então uma tarefa de monitoramento pode executá-lo quantas vezes o seu limite por minuto permitir.
Minha pesquisa funcionou, mas um resultado não tem conteúdo. Isso é uma queda?
Não. Essa página não pôde ser lida: o content_status dela diz o motivo. Nosso leitor respeita o robots.txt: ele se identifica como LLMWebSearch, segue as regras que um site escreve para ele ou para todos os robôs e deixa de fora o conteúdo de qualquer página que não tem permissão para ler.
A quem informo um problema que a verificação de integridade não mostra?
Ao suporte em [email protected], com o horário, o endpoint e uma resposta completa com falha. Uma pessoa responde em até 12 horas.