HTTP-Methoden

HTTP-Methoden sind wie "Aktionsbefehle" für deine Daten.

In RESTful-APIs verwenden wir hauptsächlich vier Methoden, die den vier grundlegenden Operationen auf Daten entsprechen:

HTTP-Methode Zweck Entsprechende Operation Alltagsanalogie
GET Daten abrufen Read Menü anzeigen
POST Daten erstellen Erstelle Gerichte bestellen
PUT Daten aktualisieren Update Bestellung ändern
DELETE Daten löschen Delete Bestellung stornieren

GET-Methode

GET wird verwendet, um Daten abzurufen, genau wie wenn man den Kellner fragt: „Welche Gerichte haben Sie heute?“

// 获取所有用户
GET /api/users

// 获取特定用户
GET /api/users/123

// 获取用户的订单
GET /api/users/123/orders

Funktionen:

  • Sichere Operation, verändert keine Daten
  • Kann zwischengespeichert werden
  • Parameter werden in der URL platziert

POST-Methode

POST wird verwendet, um neue Daten zu erstellen, genau wie wenn man dem Kellner sagt: „Ich möchte ein Kung Pao Chicken bestellen“

// 创建新用户
POST /api/users
{
  "name": "张三",
  "email": "zhangsan@example.com"
}

// 创建新订单
POST /api/orders
{
  "userId": 123,
  "items": ["商品A", "商品B"]
}

Funktionen:

  • Ändert den Serverzustand
  • Nicht idempotent (mehrere Aufrufe erstellen mehrere Ressourcen)
  • Daten werden im Request-Body platziert

PUT-Methode

PUT wird verwendet, um die gesamte Ressource zu aktualisieren, genau wie wenn man sagt: „Ändern Sie meine Bestellung in dies“

// 更新用户信息
PUT /api/users/123
{
  "name": "李四",
  "email": "lisi@example.com",
  "phone": "13800138000"
}

Funktionen:

  • Ist idempotent (mehrere Aufrufe erzeugen dasselbe Ergebnis)
  • Ersetzt normalerweise die gesamte Ressource
  • Wenn die Ressource nicht existiert, kann eine neue Ressource erstellt werden

DELETE-Methode

DELETE wird verwendet, um eine Ressource zu löschen, so wie wenn man sagt: „Meine Bestellung stornieren“

// 删除用户
DELETE /api/users/123

// 删除订单
DELETE /api/orders/456
  • Ist idempotent
  • Löscht die angegebene Ressource
  • Nach Erfolg existiert die Ressource nicht mehr

HTTP-Statuscodes

Nachdem der Server die Anfrage verarbeitet hat, gibt er einen Statuscode zurück, um Ihnen das Ergebnis mitzuteilen:

Statuscode Bedeutung Beschreibung
200 Gut Anfrage erfolgreich
201 Erstellt Ressource erfolgreich erstellt
400 Ungültige Anfrage Ungültige Anfrage
401 Nicht autorisiert Nicht autorisiert
404 Nicht gefunden Ressource nicht gefunden
500 Interner Serverfehler Interner Serverfehler
Weitere Erweiterungen