Forbidden - perhaps check your credentials?
API-ul a răspuns 403 Forbidden: te-a recunoscut, dar contul, cheia sau tokenul nu au drept pentru resursa ori operația cerută. Cere sau folosește o cheie cu drepturile potrivite (scope-uri, rol), sau cere doar resursele la care ai acces.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
403 înseamnă „știu cine ești, dar nu ai voie aici”. n8n afișează mesajul „Forbidden - perhaps check your credentials?”, iar în detalii apare de obicei explicația serverului (de exemplu „insufficient permissions”, „missing scope”, „IP not allowed”).
Spre deosebire de 401, schimbarea cheii cu aceeași cheie scrisă corect nu ajută. Cauzele: cheia e doar de citire și încerci să scrii; tokenul OAuth nu are scope-ul necesar (de exemplu doar read pe Google Sheets); utilizatorul nu are acces la acel document, proiect sau cont; API-ul acceptă doar anumite adrese IP; ai atins o limită a planului.
Cum depanezi: citește corpul răspunsului din detaliile erorii, verifică în contul serviciului drepturile cheii sau ale aplicației OAuth și ce resursă ceri exact. Pentru OAuth, după ce adaugi scope-uri trebuie să reconectezi credențiala, ca tokenul nou să le includă.
De ce apare: cauzele frecvente
1Resursă la care cheia nu are acces
GET https://api.firma.ro/rapoarte/financiar (cheia echipei de vânzări)GET https://api.firma.ro/rapoarte/vanzari (resursa permisă echipei)Cheia e validă, dar rolul ei nu include rapoartele financiare.
2Token OAuth fără scope de scriere
Credențială Google cu scope doar de citire, operație AppendReconectează credențiala cu scope-ul de scriere (spreadsheets), apoi AppendScope-urile se aleg la conectare; un token vechi nu primește automat drepturi noi.
3Documentul nu e partajat cu contul
Google Sheets: foaie a altui utilizator, nepartajatăPartajează foaia cu contul folosit de credențială (Editor)Contul conectat trebuie să aibă acces la documentul respectiv.
Repară eroarea, direct în pagină
Nodul Raport cere https://api.firma.ro/rapoarte/financiar și primește 403 („Forbidden - perhaps check your credentials?”): cheia echipei de vânzări nu are acces la rapoartele financiare. Schimbă URL-ul pe raportul permis echipei, https://api.firma.ro/rapoarte/vanzari, și rulează.
Indiciu
Cheia e corectă; problema e resursa cerută.
Reparația
1. Raport → URL: https://api.firma.ro/rapoarte/vanzari. 2. Execute workflow:
{ "raport": "Vânzări martie", "total": 48250 }De ce merge
403 spune că serverul a acceptat cheia, dar rolul ei nu include resursa cerută. Reîncercarea sau rescrierea cheii nu schimbă nimic. Cerând raportul la care echipa are drept, serverul răspunde 200 cu datele de vânzări. Dacă ai nevoie chiar de raportul financiar, soluția e o cheie cu alt rol, cerută administratorului.
Alte forme ale mesajului
403 - {"message":"Forbidden"}Request failed with status code 403The caller does not have permission
Cum o eviți pe viitor
- Dă fiecărei automatizări o cheie cu exact drepturile de care are nevoie și notează-le în descrierea credențialei.
- La OAuth, alege scope-urile de la început și reconectează după orice schimbare.
- Partajează documentele și folderele cu contul tehnic folosit de n8n, nu cu cel personal.
- Citește întotdeauna corpul răspunsului: aproape mereu spune ce drept lipsește.
Întrebări frecvente
Am verificat cheia de zece ori și e corectă. De ce tot 403?
Pentru că 403 nu înseamnă cheie greșită, ci drepturi insuficiente. Verifică rolul cheii, scope-urile și accesul la resursa exactă.
Poate fi 403 din cauza IP-ului?
Da. Unele API-uri permit doar anumite IP-uri. n8n Cloud are IP-uri publicate de n8n; pe self-hosted e IP-ul serverului tău. Adaugă-l în lista permisă a serviciului.
Erori înrudite
Authorization failed - please check your credentials API-ul a răspuns 401 Unauthorized: cererea nu are autentificare sau cheia / tokenul e greșit ori expirat. Alege în HTTP Request tipul de autentificare cerut de API (de exemplu Header Auth cu X-API-Key) și credențialele corecte, apoi rulează din nou. The resource you are requesting could not be found API-ul a răspuns 404 Not Found: adresa (calea din URL) nu există sau ID-ul cerut nu există. Verifică URL-ul în documentația API-ului (litere, singular/plural, versiune) și valoarea ID-ului din expresie. The caller does not have permission Contul Google din credențială nu are acces la documentul sau folderul cerut: foaia nu e partajată cu el (des întâlnit la Service Account) sau are doar drept de citire și nodul încearcă să scrie. Partajează documentul cu adresa contului (Editor) sau folosește documentul la care are acces. Învață n8n de la zero, cu exerciții la fiecare lecție
Curs Automatizări AI cu n8n: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
