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 |