Produkt API – Dokumentation

Base URL: https://deinserver.de/api.php

Authentifizierung erforderlich
Alle Endpunkte verlangen einen Bearer-Token im Authorization-Header:

Authorization: Bearer MEIN_GEHEIMER_TOKEN

Endpunkte

GET /api.php Alle Produkte abrufen ▼

Gibt die vollständige Liste aller Produkte zurück.

Parameter

Keine Parameter

Beispiel-Request

curl -H "Authorization: Bearer MEIN_GEHEIMER_TOKEN" \
     https://deinserver.de/api.php

Beispiel-Response 200 OK

[
  {
    "id": 1,
    "name": "Laptop Pro 15",
    "category": "Elektronik",
    "price": 1299.99,
    "stock": 12,
    "description": "Leistungsstarker Laptop mit 15-Zoll-Display"
  },
  ...
]

Status-Codes

200 OK 401 Unauthorized

GET /api.php?id={id} Einzelnes Produkt per ID ▼

Gibt ein einzelnes Produkt anhand seiner ID zurück.

Parameter

Name	Typ	Pflicht	Beschreibung
`id`	integer	Pflicht	Eindeutige Produkt-ID

Beispiel-Request

curl -H "Authorization: Bearer MEIN_GEHEIMER_TOKEN" \
     https://deinserver.de/api.php?id=1

Beispiel-Response 200 OK

{
  "id": 1,
  "name": "Laptop Pro 15",
  "category": "Elektronik",
  "price": 1299.99,
  "stock": 12,
  "description": "Leistungsstarker Laptop mit 15-Zoll-Display"
}

Status-Codes

200 OK 401 Unauthorized 404 Not Found

GET /api.php?search={term} Produkte suchen ▼

Durchsucht Name, Kategorie und Beschreibung aller Produkte (Groß-/Kleinschreibung wird ignoriert).

Parameter

Name	Typ	Pflicht	Beschreibung
`search`	string	Pflicht	Suchbegriff (wird in Name, Kategorie & Beschreibung gesucht)

Beispiel-Request

curl -H "Authorization: Bearer MEIN_GEHEIMER_TOKEN" \
     "https://deinserver.de/api.php?search=laptop"

Beispiel-Response 200 OK

[
  {
    "id": 1,
    "name": "Laptop Pro 15",
    "category": "Elektronik",
    "price": 1299.99,
    "stock": 12,
    "description": "Leistungsstarker Laptop mit 15-Zoll-Display"
  }
]

Status-Codes

200 OK 401 Unauthorized

Fehler-Antworten

ERR Fehlerformat Aufbau aller Fehlermeldungen ▼

Response-Body

{
  "error": "Beschreibung des Fehlers"
}

Mögliche Status-Codes

Code	Bedeutung
401	Token fehlt oder ist ungültig
404	Produkt nicht gefunden
405	HTTP-Methode nicht erlaubt (nur GET)
500	Datendatei fehlt oder ist beschädigt