REST-APIs im Terminal testen mit curl

Wenn ich eine App an ein Backend anbinde, teste ich jeden Endpunkt erst im Terminal mit curl – kein Postman-Fenster nötig, und ich sehe sofort, was Sache ist. Hier die Aufrufe, die 95 % abdecken.

GET – einfach abfragen

curl https://api.example.com/users/1

Willst du auch die Antwort-Header und den Statuscode sehen (praktisch zum Debuggen):

curl -i https://api.example.com/users/1     # -i zeigt die Header mit
curl -s -o /dev/null -w "%{http_code}\n" https://api.example.com/users/1  # nur der Statuscode

POST mit JSON

Der wichtigste Fall: Daten senden. Du brauchst die Methode (-X POST), den Content-Type-Header (-H) und den Body (-d):

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name": "Mia", "aktiv": true}'

Ohne den Content-Type-Header nehmen viele Server das JSON nicht an – das ist der häufigste Stolperstein.

Auth-Token mitschicken

curl https://api.example.com/profil \
  -H "Authorization: Bearer DEIN_TOKEN"

PUT und DELETE

curl -X PUT https://api.example.com/users/1 \
  -H "Content-Type: application/json" \
  -d '{"name": "Mia B."}'

curl -X DELETE https://api.example.com/users/1

Zusammen mit jq lesbar machen

Kommt JSON zurück, schick es durch jq, damit es eingerückt und lesbar ist:

curl -s https://api.example.com/users | jq .

Mit -i (Header), -X (Methode), -H (Header) und -d (Body) probierst du jeden REST-Endpunkt in Sekunden aus – lange bevor eine Zeile App-Code entsteht.

Wenn du eine App oder Website mit sauberer API-Anbindung brauchst, baue ich dir Backend und Schnittstellen dazu – meld dich über bymw.de.

Quellen

• curl – offizielle Dokumentation
• everything curl – Online-Buch