...
Eroare AWS · API Gateway și SNS

{"message":"Not Found"}

Pe scurt

Nicio rută a API-ului nu se potrivește cu metoda și calea cererii. Verifică cu aws apigatewayv2 get-routes cheile exacte (de exemplu "GET /salut"): calea e sensibilă la majuscule, iar metoda trebuie să fie aceeași. Corectează ruta sau adresa cererii.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un API HTTP din API Gateway caută pentru fiecare cerere o rută cu exact aceeași metodă și cale (GET /salut). Dacă nu găsește nicio rută și nu există ruta $default, răspunde cu statusul 404 și {"message":"Not Found"}, fără să apeleze vreo funcție.

Cauzele obișnuite:

  • calea diferă prin majuscule (/Salut față de /salut), o literă sau un / la final;
  • metoda diferă (ruta e GET, cererea e POST);
  • adresa conține numele unui stage care nu există (/prod/salut, când API-ul are doar $default) sau lipsește numele stage-ului;
  • ai creat ruta, dar stage-ul nu are --auto-deploy, deci modificarea nu a fost publicată.

Vezi rutele cu aws apigatewayv2 get-routes --api-id $API --query 'Items[].RouteKey' și stage-urile cu get-stages.

De ce apare: cauzele frecvente

1Majuscule diferite în cale

Greșit
BASH
aws apigatewayv2 create-route --api-id $API --route-key "GET /Salut" ...
curl https://$API.execute-api.eu-central-1.amazonaws.com/salut
Corect
BASH
aws apigatewayv2 update-route --api-id $API --route-id $RUTA --route-key "GET /salut"

Căile sunt sensibile la majuscule; ruta trebuie să fie exact /salut.

2Metoda nu se potrivește

Greșit
BASH
aws apigatewayv2 create-route --api-id $API --route-key "GET /rezervari" ...
curl -X POST https://$API.execute-api.eu-central-1.amazonaws.com/rezervari
Corect
BASH
aws apigatewayv2 create-route --api-id $API --route-key "POST /rezervari" \
  --target integrations/$INT

Fiecare metodă are ruta ei (sau folosești ANY /rezervari).

3Stage în adresă

Greșit
BASH
curl https://$API.execute-api.eu-central-1.amazonaws.com/prod/salut
# API-ul are doar stage-ul $default
Corect
BASH
curl https://$API.execute-api.eu-central-1.amazonaws.com/salut

Stage-ul $default nu apare în adresă; un stage cu nume (prod) apare.

Repară tu

Repară eroarea, direct în pagină

Site-ul apelează GET /salut?nume=Ana pe API-ul magazin-api, dar primește {"message":"Not Found"}. Ruta a fost creată ca GET /Salut. Repară ruta (fără să creezi alta) ca cererile spre /salut să ajungă la funcția api-salut, apoi verifică cu curl.

Indiciu

Găsește RouteId-ul cu aws apigatewayv2 get-routes și schimbă cheia cu aws apigatewayv2 update-route --route-key "GET /salut".

Alte forme ale mesajului

  • HTTP/1.1 404 Not Found
  • {"message":"Missing Authentication Token"}

Cum o eviți pe viitor

  • Scrie căile cu litere mici și fără / la final, peste tot (rute, frontend, documentație).
  • După modificări, listează rutele: aws apigatewayv2 get-routes --api-id $API --query 'Items[].RouteKey'.
  • Folosește un stage cu --auto-deploy sau publică manual după fiecare schimbare.

Întrebări frecvente

Ce e „Missing Authentication Token”?

Este echivalentul lui Not Found la API-urile REST din API Gateway (nu HTTP API): calea sau metoda nu există. Mesajul derutează, dar rareori are legătură cu autentificarea.

Cum prind toate căile într-o singură funcție?

Cu ruta $default sau ANY /{proxy+}. Funcția primește calea în event.rawPath și decide singură ce să răspundă.

Erori înrudite

← Toate erorile AWS

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ță AWS de la zero, cu exerciții la fiecare lecție

Curs Cloud: AWS fundamentals: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.