Entwickler

Diese Seite richtet sich an Entwickler, die Daten von WHISKY:EDITION nutzen möchten. Die API liefert JSON und ist für Integrationen gedacht. Lizenz- und Nutzungsdetails findest du im Impressum.

Wenn du die API in einer Website, App, Dashboard oder Tool nutzt, musst du auf WHISKY:EDITION als Quelle verlinken.

Wir sind sehr interessiert an echten Anwendungsfällen. Schreib uns bitte kurz, warum und wie du die API nutzt: hallo@whiskyedition.de

API Endpunkte

Öffentliche Endpunkte und Beispiele für die Integration mit der API.

Englische Endpunkte


                                
                                    Name
                                    Reviews List
                                
                                
                                    Endpunkt
                                    GET https://thewhiskyedition.com/api/whisky-reviews/?page=<page>&per_page=<per_page>
                                
                                
                                    Beispiel
                                    curl "https://thewhiskyedition.com/api/whisky-reviews/?page=1&per_page=24"
                                
                                
                                    Antwort
                                    {"ok":true,"lang":"en|de","count":...,"total":...,"page":...,"per_page":...,"items":[...]}
                                
                            

                                
                                    Name
                                    Review Detail
                                
                                
                                    Endpunkt
                                    GET https://thewhiskyedition.com/api/whisky-reviews/<slug>
                                
                                
                                    Beispiel
                                    curl "https://thewhiskyedition.com/api/whisky-reviews/wild-turkey-rare-breed"
                                
                                
                                    Antwort
                                    {"ok":true,"lang":"en|de","item":{...}}
                                
                            

                                
                                    Name
                                    Suche
                                
                                
                                    Endpunkt
                                    GET https://thewhiskyedition.com/api/search/?q=<query>&limit=<limit>
                                
                                
                                    Beispiel
                                    curl "https://thewhiskyedition.com/api/search/?q=ardbeg&limit=10"
                                
                                
                                    Antwort
                                    {"ok":true,"lang":"en|de","query":"...","count":...,"items":[...]}
                                
                            

                                
                                    Name
                                    OpenAPI
                                
                                
                                    Endpunkt
                                    GET https://thewhiskyedition.com/openapi.yaml
                                
                                
                                    Beispiel
                                    curl "https://thewhiskyedition.com/openapi.yaml"
                                
                                
                                    Antwort
                                    YAML (OpenAPI 3.0)
                                
                            

Deutsche Endpunkte


                                
                                    Name
                                    Testberichte Liste
                                
                                
                                    Endpunkt
                                    GET https://whiskyedition.de/api/whisky-testberichte/?page=<page>&per_page=<per_page>
                                
                                
                                    Beispiel
                                    curl "https://whiskyedition.de/api/whisky-testberichte/?page=1&per_page=24"
                                
                                
                                    Antwort
                                    {"ok":true,"lang":"en|de","count":...,"total":...,"page":...,"per_page":...,"items":[...]}
                                
                            

                                
                                    Name
                                    Testbericht Detail
                                
                                
                                    Endpunkt
                                    GET https://whiskyedition.de/api/whisky-testberichte/<slug>
                                
                                
                                    Beispiel
                                    curl "https://whiskyedition.de/api/whisky-testberichte/wild-turkey-rare-breed"
                                
                                
                                    Antwort
                                    {"ok":true,"lang":"en|de","item":{...}}
                                
                            

                                
                                    Name
                                    Suche
                                
                                
                                    Endpunkt
                                    GET https://whiskyedition.de/api/search/?q=<query>&limit=<limit>
                                
                                
                                    Beispiel
                                    curl "https://whiskyedition.de/api/search/?q=ardbeg&limit=10"
                                
                                
                                    Antwort
                                    {"ok":true,"lang":"en|de","query":"...","count":...,"items":[...]}
                                
                            

                                
                                    Name
                                    OpenAPI
                                
                                
                                    Endpunkt
                                    GET https://whiskyedition.de/openapi.yaml
                                
                                
                                    Beispiel
                                    curl "https://whiskyedition.de/openapi.yaml"
                                
                                
                                    Antwort
                                    YAML (OpenAPI 3.0)
                                
                            

Parameter

Parameter: Listen-Endpunkt

  • page optional, Seite der Ergebnisliste (min. 1)
  • per_page optional, Anzahl pro Seite (1..100)
  • q optional, Volltextfilter über Titel/Beschreibung/Metadaten
  • country optional, Filter
  • region optional, Filter
  • distillery optional, Filter
  • bottler optional, Filter
  • flavour optional, Filter
  • type optional, Filter
  • min_age optional, Untergrenze Alter
  • max_age optional, Obergrenze Alter
  • min_abv optional, Untergrenze Alkoholgehalt
  • max_abv optional, Obergrenze Alkoholgehalt
  • min_price optional, Untergrenze Preis pro Liter
  • max_price optional, Obergrenze Preis pro Liter

Parameter: Detail-Endpunkt

  • slug Pfad-Parameter, erforderlich

Parameter: Suche

  • q erforderlich, mindestens 2 Zeichen
  • limit optional, Ergebnislimit (1..100, Standard: 50)

Fehlercodes

Fehlercodes: Reviews API

  • 400 Ungültige Request-Parameter.
  • 404 Review oder Endpunkt nicht gefunden.
  • 405 Methode nicht erlaubt.
  • 429 Zu viele Anfragen.
  • 500 Serverfehler.

Fehlercodes: Search API

  • 400 Ungültige Suchanfrage oder ungültige Parameter.
  • 405 Methode nicht erlaubt.
  • 500 Serverfehler.