API-Dokumentation
Mit der Apolotse API rufst du Produktdaten und die zuletzt erfassten Apothekenangebote für deine freigeschalteten PZN ab.
In drei Schritten zur API
Konto einrichten
Kontostatus wird geladen…
PZN freischalten
Füge unter Einstellungen die gewünschte PZN hinzu.
API-Token erstellen
Nach der Anmeldung kannst du deinen Bearer-Token direkt weiter unten auf dieser Seite erstellen und kopieren.
GET/api/products/{pzn}
Der Endpunkt liefert Produktdaten und das zuletzt erfasste Angebot jeder Apotheke. Die PZN muss genau acht Ziffern lang und deinem Konto zugeordnet sein.
Übermittle deinen Token im Authorization-Header im Format Bearer <token>.
Anfrage
curl "https://apolotse.alpha-alpaka.de/api/products/01292358" \
--header "Authorization: Bearer $APOLOTSE_API_TOKEN"Antwort
{
"manufacturer": "Beispielhersteller",
"model": "100 g",
"name": "Beispielprodukt",
"offers": [
{
"availability": "InStock",
"price": 13.49,
"priceLastUpdatedAt": "2026-07-13T08:42:16.000Z",
"ratingAvg": 4.8,
"ratingCount": 127,
"ratingPercentage": 96,
"sellerId": 2,
"sellerLogoUrl": "https://beispiel-apotheke.test/logo.svg",
"sellerName": "Beispielapotheke",
"url": "https://beispiel-apotheke.test/produkt"
}
],
"pzn": "01292358"
}Produktmetadaten und Angebotswerte können null sein. Ein leeres offers-Array bedeutet, dass noch keine Angebote erfasst wurden, das kann dann noch ein paar Minuten dauern.
Fehler
| HTTP-Status | Bedeutung |
|---|---|
400 | Ungültige PZN. |
401 | Fehlender oder ungültiger Bearer-Token. |
403 | Dein Konto hat keinen Zugriff auf diese PZN. |
429 | Zu viele Anfragen. |