...
Eroare n8n · HTTP Request și API-uri

Forbidden - perhaps check your credentials?

Pe scurt

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

Greșit
JSON
GET https://api.firma.ro/rapoarte/financiar   (cheia echipei de vânzări)
Corect
JSON
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

Greșit
JSON
Credențială Google cu scope doar de citire, operație Append
Corect
JSON
Reconectează credențiala cu scope-ul de scriere (spreadsheets), apoi Append

Scope-urile se aleg la conectare; un token vechi nu primește automat drepturi noi.

3Documentul nu e partajat cu contul

Greșit
JSON
Google Sheets: foaie a altui utilizator, nepartajată
Corect
JSON
Partajează foaia cu contul folosit de credențială (Editor)

Contul conectat trebuie să aibă acces la documentul respectiv.

Repară tu

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ă.

Alte forme ale mesajului

  • 403 - {"message":"Forbidden"}
  • Request failed with status code 403
  • The 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

← Toate erorile n8n

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.