Zum Inhalt springen
BeispielWerk
English

REST-API Aufrufe mit curl: GET, POST, PUT, DELETE

REST-Aufrufe verbinden eine HTTP-Methode mit einem Pfad und liefern einen Statuscode samt Rumpf zurück. Die Seite zeigt je Beispiel die curl-Anfrage und die passende Antwort für GET, POST, PUT, PATCH und DELETE, darunter ein 404 und ein Validierungsfehler mit 422. example.com ist eine für Beispiele reservierte Domain (RFC 2606); eine API mit diesen Endpunkten gibt es dort nicht.

13 Varianten auf einer Seite, jede mit eigenem Kopier- oder Download-Knopf. Darunter: 13× Fiktiv.

  • REST: GET /kunden (Liste)Fiktiv

    # Anfrage
    curl -i "https://example.com/api/kunden?seite=1&pro_seite=2"
     …

    example.com ist für Beispiele reserviert (RFC 2606); die Schnittstelle ist erfunden, eine API mit diesen Endpunkten gibt es dort nicht.

  • REST: GET /kunden/1 (Einzelabruf)Fiktiv

    # Anfrage
    curl -i https://example.com/api/kunden/1
     …

    example.com ist für Beispiele reserviert (RFC 2606); die Schnittstelle ist erfunden, eine API mit diesen Endpunkten gibt es dort nicht.

  • REST: GET /kunden/999 (nicht gefunden)Fiktiv

    # Anfrage
    curl -i https://example.com/api/kunden/999
     …

    example.com ist für Beispiele reserviert (RFC 2606); die Schnittstelle ist erfunden, eine API mit diesen Endpunkten gibt es dort nicht.

  • REST: POST /kunden (anlegen, 201 mit Location)Fiktiv

    # Anfrage
    curl -i -X POST https://example.com/api/kunden \
      -H "Content-Type: application/json" \ …

    example.com ist für Beispiele reserviert (RFC 2606); die Schnittstelle ist erfunden, eine API mit diesen Endpunkten gibt es dort nicht.

  • REST: POST /kunden (Validierungsfehler 422)Fiktiv

    # Anfrage
    curl -i -X POST https://example.com/api/kunden \
      -H "Content-Type: application/json" \ …

    example.com ist für Beispiele reserviert (RFC 2606); die Schnittstelle ist erfunden, eine API mit diesen Endpunkten gibt es dort nicht.

  • REST: PUT /kunden/1 (ersetzen, 200)Fiktiv

    # Anfrage
    curl -i -X PUT https://example.com/api/kunden/1 \
      -H "Content-Type: application/json" \ …

    example.com ist für Beispiele reserviert (RFC 2606); die Schnittstelle ist erfunden, eine API mit diesen Endpunkten gibt es dort nicht.

  • REST: PATCH /kunden/1 (teilweise ändern)Fiktiv

    # Anfrage
    curl -i -X PATCH https://example.com/api/kunden/1 \
      -H "Content-Type: application/json" \ …

    example.com ist für Beispiele reserviert (RFC 2606); die Schnittstelle ist erfunden, eine API mit diesen Endpunkten gibt es dort nicht.

  • REST: DELETE /kunden/1 (204 ohne Inhalt)Fiktiv

    # Anfrage
    curl -i -X DELETE https://example.com/api/kunden/1
     …

    example.com ist für Beispiele reserviert (RFC 2606); die Schnittstelle ist erfunden, eine API mit diesen Endpunkten gibt es dort nicht.

  • REST: Anfrage ohne Anmeldung (401)Fiktiv

    # Anfrage
    curl -i https://example.com/api/profil
     …

    example.com ist für Beispiele reserviert (RFC 2606); die Schnittstelle ist erfunden, eine API mit diesen Endpunkten gibt es dort nicht.

  • REST: zu viele Anfragen (429)Fiktiv

    # Anfrage
    curl -i https://example.com/api/suche?q=test
     …

    example.com ist für Beispiele reserviert (RFC 2606); die Schnittstelle ist erfunden, eine API mit diesen Endpunkten gibt es dort nicht.

  • REST: Serverfehler (500)Fiktiv

    # Anfrage
    curl -i https://example.com/api/berichte/monat
     …

    example.com ist für Beispiele reserviert (RFC 2606); die Schnittstelle ist erfunden, eine API mit diesen Endpunkten gibt es dort nicht.

  • REST: bedingter Abruf mit ETag (304)Fiktiv

    # Anfrage
    curl -i https://example.com/api/kunden/1 -H 'If-None-Match: "v7"'
     …

    example.com ist für Beispiele reserviert (RFC 2606); die Schnittstelle ist erfunden, eine API mit diesen Endpunkten gibt es dort nicht.

  • REST: Weiterleitung (301)Fiktiv

    # Anfrage
    curl -i https://example.com/api/v1/kunden
     …

    example.com ist für Beispiele reserviert (RFC 2606); die Schnittstelle ist erfunden, eine API mit diesen Endpunkten gibt es dort nicht.

Weitere Themen in Mock-Daten & API-Antworten