Testador de CORS — Depure Erros de CORS

Bloqueado por um erro de CORS? Informe o endereço da API e a origem do seu site. Enviamos as mesmas requisições que um navegador faria, mostramos exatamente o que falha e indicamos a correção no servidor.

Atualizado em

Esta ferramenta busca pelo nosso servidor a URL pública que você digitar. Os resultados ficam alguns minutos na memória temporária e nunca são salvos em banco de dados.

Como usar: Testador de CORS

  1. Informe o endereço da API que está falhando e o endereço do seu site como origem.
  2. Escolha o método e adicione os headers personalizados necessários, como Authorization.
  3. Marque Enviar cookies se sua requisição usar credenciais e clique em Testar CORS.
  4. Veja o que falhou e copie a correção para o seu servidor.

O que é CORS?

Os navegadores impedem que uma página de um site leia respostas de outro, a menos que o outro servidor permita. O Cross-Origin Resource Sharing é o mecanismo que faz essa permissão, usando headers de resposta Access-Control-Allow-*. A correção precisa ser feita no servidor, não no seu código front-end.

O que é um preflight?

Em algumas requisições, como PUT, DELETE ou aquelas com header Authorization, o navegador envia primeiro uma requisição OPTIONS para pedir permissão. Se ela falhar, a requisição real nem chega a acontecer.

Erros comuns de CORS

  • Sem header Access-Control-Allow-Origin: o servidor não adicionou os headers de CORS. Páginas de erro muitas vezes também não os incluem, então verifique se a requisição não está falhando por outro motivo.
  • Curinga com credenciais: * não pode ser usado com cookies. Envie a origem exata.
  • Preflight falha: seu servidor precisa responder OPTIONS com status 2xx, antes de qualquer verificação de login.
  • Valores duplicados: duas camadas, como um proxy e a aplicação, podem estar adicionando o header ao mesmo tempo.

Mantenha a segurança

Permita apenas origens em que você confia. Não copie de volta o header Origin recebido sem validá-lo contra uma lista, especialmente com credenciais, pois qualquer site poderia então ler os dados dos seus usuários.

Quer montar os headers do zero? Use o Gerador de Headers CORS. Para inspecionar uma resposta completa, experimente o Verificador de Headers HTTP.

Também pesquisado como: verificador de cors, testar cors, erro de cors, blocked by cors policy, access-control-allow-origin checker, teste de preflight cors, no access-control-allow-origin header.

Ferramentas que combinam com: Testador de CORS

  • Testador de API — Uma alternativa leve ao Postman no seu navegador: monte uma requisição HTTP, envie e veja status, tempo, headers e o JSON formatado.
  • Verificador de Headers de Segurança — Dê uma nota de A+ a F aos headers de segurança HTTP de um site, veja quais estão faltando e por que eles importam, e copie trechos de configuração prontos para Nginx, Apache, Netlify, Vercel ou Cloudflare.
  • Códigos de Status HTTP — Todo código de resposta HTTP padrão explicado em linguagem simples, com quando usar e como afeta o SEO.
  • Analisador de Cabeçalho de E-mail — Cole os cabeçalhos brutos de um e-mail para ver todo o seu percurso: cada salto entre servidores com o tempo que levou, os resultados de SPF, DKIM e DMARC, o IP de origem e sinais de alerta, como um Reply-To ou Return-Path divergente.

Perguntas frequentes

Por que minha API funciona no Postman, mas não no navegador?
O CORS é aplicado pelos navegadores. O Postman não o aplica, então a mesma requisição pode funcionar lá e ainda falhar no seu site.
Posso corrigir o CORS no front-end?
Não. O servidor precisa enviar os headers. Se você não controla o servidor, chame a API pelo seu próprio backend.
Access-Control-Allow-Origin: * é seguro?
É adequado para dados públicos que não exigem login. Não use para dados privados.
Este teste é igual a um navegador real?
Ele envia requisições do mesmo tipo a partir do nosso servidor e aplica as regras do navegador. Os resultados podem variar se o seu servidor tratar visitantes ou localizações de forma diferente.

Ferramentas relacionadas