curl: (22) The requested URL returned error: 404
Serverul a răspuns, dar cu un cod de eroare HTTP (aici 404, pagina nu există), iar opțiunea -f (--fail) l-a făcut pe curl să iasă cu codul 22. Verifică adresa (calea, numele fișierului, litere mari) cu curl -I sau în browser și corecteaz-o.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Implicit, curl salvează orice răspuns, chiar și pagina de eroare, și iese cu 0. Cu -f (--fail), un cod HTTP de 400 sau mai mare devine eroare: curl nu salvează corpul răspunsului, afișează The requested URL returned error: 404 și iese cu codul 22. E comportamentul dorit în scripturi, ca un fișier lipsă să nu treacă neobservat.
Codul din mesaj îți spune problema: 404 = calea nu există pe server (greșeală de tastare, versiune veche a API-ului, / lipsă), 401/403 = lipsește autentificarea sau nu ai acces, 500/502/503 = serverul are o problemă. Pentru detalii rulează curl -i URL (arată și antetele răspunsului) sau curl -I URL (doar antetele). Diferența față de curl: (7) e importantă: acolo nu s-a putut face conexiunea deloc; aici serverul a răspuns.
De ce apare: cauzele frecvente
1Calea sau numele fișierului greșit
curl -fsS -o cursuri.json http://server/api/curs.jsoncurl -fsS -o cursuri.json http://server/api/cursuri.jsonServerul are fișierul cursuri.json, nu curs.json. Pe Linux contează și literele mari.
2Lipsește autentificarea
curl -f https://api.exemplu.ro/v1/comenzicurl -f -H "Authorization: Bearer $TOKEN" https://api.exemplu.ro/v1/comenziUn 401 sau 403 înseamnă că serverul cere un token sau o cheie.
3Eroarea ascunsă fără -f
curl -s -o date.csv http://server/date-vechi.csvcurl -fsS -o date.csv http://server/date.csvFără -f, date.csv ar conține pagina HTML de eroare și scriptul ar continua cu date greșite.
Repară eroarea, direct în pagină
Scriptul descarca.sh trebuie să descarce lista cursurilor de la http://server/api/ în cursuri.json. Rulat, dă curl: (22) The requested URL returned error: 404. Află adresa corectă din documentația API-ului (fișierul api.txt din folderul curent), repară scriptul și rulează-l, ca cursuri.json să conțină lista.
Indiciu
Compară adresa din script cu cea din api.txt.
Reparația
cat api.txt
sed -i 's|/api/curs.json|/api/cursuri.json|' descarca.sh
./descarca.sh
head -3 cursuri.jsonDe ce merge
Serverul a răspuns, dar cu 404: calea /api/curs.json nu există. Cu -f, curl a transformat răspunsul de eroare în codul de ieșire 22 și nu a salvat nimic, ceea ce e exact ce vrei într-un script.
Documentația din api.txt arată adresa corectă, /api/cursuri.json. După corectare, curl descarcă lista în cursuri.json și iese cu 0.
Alte forme ale mesajului
curl: (22) The requested URL returned error: 403curl: (22) The requested URL returned error: 500curl: (22) The requested URL returned error: 404 Not FoundERROR 404: Not Found.HTTP/1.1 404 Not Found
Cum o eviți pe viitor
- În scripturi folosește
curl -fsS(-feșuează la erori HTTP,-sfără bară de progres,-Sarată totuși erorile). - Verifică adresa cu
curl -I URLînainte s-o pui în script. - Pentru API-uri, afișează codul cu
curl -s -o /dev/null -w '%{http_code}\n' URL. - Testează în script codul de ieșire:
curl -fsS ... || { echo 'descarcare esuata'; exit 1; }.
Întrebări frecvente
De ce fără -f curl spune că totul e în regulă?
Pentru că din punctul lui de vedere a primit un răspuns complet. Codul HTTP 404 e doar conținutul răspunsului. -f îi spune să trateze codurile de eroare ca eșec.
Care e diferența față de curl: (7)?
La 7 nu s-a putut face conexiunea (serverul nu ascultă, portul e închis). La 22 conexiunea a mers și serverul a răspuns cu o eroare HTTP.
Erori înrudite
curl: (7) Failed to connect to localhost port 80 after 0 ms: Couldn't connect to server Numele a fost găsit, dar pe portul cerut nu ascultă niciun program (sau un firewall respinge conexiunea). Verifică dacă serviciul rulează (systemctl status nginx) și pe ce port ascultă (ss -tln), pornește-l sau folosește portul corect. curl: (6) Could not resolve host: api.acadmia.ro Numele din URL nu a putut fi tradus într-o adresă IP: de obicei e scris greșit, nu are încă înregistrare DNS sau serverul nu are DNS/internet. Verifică numele caracter cu caracter, apoi cu getent hosts sau dig dacă se rezolvă. jq: error (at <stdin>:1): Cannot index array with "nume" JSON-ul primit e o listă ([...]), iar tu ai cerut un câmp ca la un obiect (.nume). Parcurge întâi lista cu .[] și abia apoi alege câmpul: jq -r '.[].nume'. Uită-te la forma datelor cu jq . înainte să scrii filtrul. Învață Linux de la zero, cu exerciții la fiecare lecție
Curs Linux: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
