CORS Error: The request has been blocked because of the CORS policy
Folosești Postman în browser cu Browser Agent, iar browserul blochează răspunsul pentru că serverul nu permite originea paginii Postman (lipsește Access-Control-Allow-Origin). Comută pe Desktop Agent sau Cloud Agent; dacă testezi chiar CORS-ul API-ului, verifici antetele de răspuns.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
CORS (Cross-Origin Resource Sharing) e o regulă a browserelor: o pagină de pe un domeniu poate citi răspunsuri de la alt domeniu doar dacă serverul o permite prin antete (Access-Control-Allow-Origin și înrudite).
Aplicația Postman Desktop și Newman nu sunt browsere, deci nu aplică CORS. Eroarea apare doar în Postman web cu Browser Agent, unde cererea pleacă efectiv din browser, de pe pagina go.postman.co, iar serverul tău nu a permis această origine.
Două situații diferite:
- vrei doar să testezi API-ul: alegi Desktop Agent (sau Cloud Agent pentru adrese publice) și problema dispare;
- testezi chiar politica CORS a API-ului, pentru aplicația web reală: trimiți antetul
Origincu domeniul aplicației și verifici anteteleAccess-Control-Allow-*din răspuns.
CORS nu e o protecție a API-ului: orice client care nu e browser îl ignoră.
De ce apare: cauzele frecvente
1Browser Agent pentru un API fără CORS
Postman web, Agent: Browser
GET https://api.magazin.test/productsPostman web, Agent: Desktop (sau aplicația desktop)
GET https://api.magazin.test/productsFără browser la mijloc, regula CORS nu se aplică.
2Testarea CORS fără antetul Origin
GET {{baseUrl}}/products
# niciun Origin trimisGET {{baseUrl}}/products
Origin: https://magazin.test
# test: Access-Control-Allow-Origin existăServerul răspunde cu antetele CORS doar când primește o cerere cu Origin.
Repară eroarea, direct în pagină
Simulatorul nu aplică CORS, așa că exersezi verificarea pe care o faci când testezi chiar politica CORS: trimite la https://echo.test/headers o cerere GET cu antetul Origin: https://magazin.test și scrie un test care verifică faptul că serverul a primit antetul Origin (pm.response.json().headers.origin). Salvează cererea „Verificare Origin” în colecția Magazin.
Indiciu
Antetul se adaugă din tabul Headers; în body-ul de la echo.test numele antetelor sunt cu litere mici.
Reparația
Headers: Origin: https://magazin.test, apoi în Post-response:
pm.test("Originea a fost trimisă", function () {
pm.expect(pm.response.json().headers.origin).to.equal("https://magazin.test");
});De ce merge
Un server cu CORS decide după antetul Origin dacă adaugă Access-Control-Allow-Origin. Trimițând Origin explicit din Postman, reproduci ce face browserul și poți testa răspunsul serverului fără agentul din browser. Pe un API real, testul următor ar fi pm.response.to.have.header("Access-Control-Allow-Origin"). Postman nu aplică politica CORS, deci aceeași cerere merge aici chiar dacă browserul o blochează. Testul confirmă că API-ul răspunde; pentru aplicația web, serverul trebuie să trimită antetele Access-Control-Allow-* potrivite.
Alte forme ale mesajului
Access to fetch at 'https://api.magazin.test/products' from origin 'https://go.postman.co' has been blocked by CORS policyCORS Error: Response to preflight request doesn't pass access control check
Cum o eviți pe viitor
- Pentru testare API, folosește aplicația desktop sau Desktop Agent.
- Separă problemele: „API-ul merge” se testează în Postman, „aplicația web poate apela API-ul” se testează cu antetul Origin sau din browser.
- Nu cere dezvoltatorilor să deschidă CORS pentru orice origine doar ca să meargă Postman web.
Întrebări frecvente
De ce merge în aplicația desktop?
Aplicația desktop nu e un browser și nu aplică politica CORS.
Trebuie reparat API-ul?
Doar dacă aplicația web reală are aceeași eroare în consola browserului. Pentru Postman, schimbarea agentului e suficientă.
Erori înrudite
Cloud Agent Error: Can't send requests to localhost Folosești Postman în browser cu Cloud Agent, care trimite cererile de pe serverele Postman și nu poate ajunge la localhost-ul tău. Instalează și selectează Desktop Agent, folosește aplicația Postman Desktop sau testează pe un mediu public (ori pe un mock server). Error: tunneling socket could not be established, cause=connect ECONNREFUSED 127.0.0.1:8888 Postman încearcă să treacă prin proxy-ul configurat (aici 127.0.0.1:8888), dar proxy-ul nu răspunde. Oprește proxy-ul din Settings → Proxy dacă nu ai nevoie de el, pornește-l (de exemplu Fiddler, Charles) sau corectează adresa proxy-ului firmei. AssertionError: expected response to have header with key 'X-Total-Items' Răspunsul nu are antetul pe care îl cere testul. Verifică în tabul Headers numele exact (aici API-ul folosește X-Total-Count) și dacă endpoint-ul chiar trimite acel antet (listele da, un singur produs nu). Învață Postman de la zero, cu exerciții la fiecare lecție
Curs API Testing cu Postman: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
