Resposta rápida
Como verificar se a API do SerpCrypto está funcionando?
Chame GET https://serpcrypto.com/api/v1/credits com sua chave: é gratuito e responde em JSON com seus créditos restantes. Um 200 significa que a API e sua chave funcionam. Os erros 502 e 504 vêm de uma pesquisa que falhou e nunca são cobrados. SerpCrypto publica incidentes no changelog; não publica nenhum número de uptime até que seja medido.
curl -s https://serpcrypto.com/api/v1/credits -H "Authorization: Bearer $SERPCRYPTO_API_KEY"O que significa cada resposta?
| Status HTTP | Significado | Cobrado? | O que fazer |
|---|---|---|---|
| 200 | A API funciona; para uma pesquisa, os resultados estão no corpo | 1 crédito por uma pesquisa bem-sucedida; a verificação de créditos é gratuita | Nada |
401 invalid_api_key | A chave está faltando, errada ou foi revogada | Não | Copie a chave novamente do painel |
402 insufficient_credits | Sua conta não tem mais créditos | Não | Compre um pacote na página de preços |
429 concurrency_limit | Muitas pesquisas ao mesmo tempo | Não | Reduza as requisições paralelas ou peça um limite maior |
502 search_failed | A pesquisa não pôde ser concluída | Não | Tente novamente após uma breve espera |
504 search_timeout | Sem resposta a tempo | Não | Tente novamente após uma breve espera |
O problema está do meu lado, do lado de vocês ou do mecanismo?
Execute primeiro a verificação gratuita, depois uma pesquisa simples e, em seguida, sua requisição real. Cada etapa isola uma camada.
- A chamada de créditos falha com 401: o problema é a chave. Verifique o formato do header:
Authorization: Bearer <key>, com um espaço. - A chamada de créditos funciona, mas toda pesquisa retorna 502: a camada de coleta ou o mecanismo está falhando para todos. Aguarde alguns minutos e tente novamente; nada é cobrado enquanto isso.
- Uma consulta simples funciona, mas a sua falha com 400: um parâmetro está fora da lista permitida. A referência de pesquisa lista todos os valores.
- Os resultados parecem diferentes do seu navegador: isso geralmente é localização, idioma ou dispositivo. Defina
gl,hl,locationedevicepara corresponder ao que você usa como comparação; veja localizações e idiomas.
Onde os incidentes e as mudanças são publicados?
No changelog. Cada entrada tem uma data, o que foi afetado (um mecanismo, um campo, a área do cliente ou pagamentos) e o que mudou. Um campo adicionado também aparece lá, para que um parser possa ser atualizado antes de precisar do campo.
Não mantemos um site de status separado, e esta página não mostra nenhuma luz verde que possa estar desatualizada. A verificação gratuita acima informa o estado real da API para a sua chave, no momento em que você consulta.
Por que não há uma porcentagem de uptime aqui?
Porque ainda não medimos uma com um método publicado. Um número de uptime significa uma sonda definida, um período definido e uma falha definida. Quando tivermos isso, ele aparecerá aqui com seu método e sua data. Até então, a promessa honesta é a regra de cobrança: 1 crédito = 1 solicitação de pesquisa bem-sucedida, que retorna uma página de resultados em qualquer engine compatível. Uma solicitação que falha não é cobrada.
O que devo enviar ao suporte durante um incidente?
Escreva para [email protected] com o ID da requisição de search_metadata.id (ou o horário da requisição, se não houve resposta), o mecanismo, o status HTTP e o código de erro. Nunca inclua sua chave de API. Respostas por e-mail em até 12 horas, 7 dias por semana, incluindo ajuda com a integração da API. A página de contato lista os outros detalhes que aceleram uma resposta.