PORTAL und PPS Knowledge Base

Location API

Owned by Boris Braun, created
Last updated: 2024-10-25 by Ilker Oygün
2 min read

Mithilfe der PEIQ Cloud-Connect APIs (engl. Application Programming Interfaces, Programmierschnittstellen) können Verlage Teile ihrer bestehenden Systeme und Produkte mit dem PEIQ PORTAL verbinden. Alle Cloud-Connect APIs sind nach der REST-Architektur aufgebaut. Der Zugriff wird dabei über die Standard HTTP-Methoden GET, POST, PUT und DELETE gesteuert. Die Zugriffskontrolle erfolgt hierbei über eine Implementierung nach OAuth V2 Standard.

Die API des Location-Moduls wird zum Ermitteln von Orts-Objekten (“Locations”) verwendet. Locations können anhand verschiedener Merkmale abgefragt werden, beispielsweise Koordinaten, Namen und PLZ. Es handelt sich bei der Location-API um eine Public API, ein Access Token ist für die Verwendung nicht notwendig. 

Funktionalitäten der Location API

  • Ermittlung von Orts-Objekten (“Locations”)

  • Abfragen von Merkmalen wie Koordinaten, Namen und PLZ

Inhaltsverzeichnis

Allgemeine Beschreibung

Die API-Dokumentation ist als interaktive Dokumentation für berechtigte Admins direkt im jeweiligen PORTAL unter /admin/api/v2/doc?module=location erreichbar.

Das swagger-File kann auch hier heruntergeladen werden (Stand: Oct 19, 2022):

 

Interaktive Dokumentation im Admin-Bereich des PORTALs

Verfügbare Endpunkte

Location

  • GET /locations: Gibt eine paginierte Liste aller Orte aus, optional kann nach einer ID-Liste gefiltert werden.

  • GET /locations/coordinates: Gibt eine paginierte Liste von Orten gefiltert nach Koordinaten aus.

  • GET /locations/name: Gibt eine paginierte Liste von Orten gefiltert nach dem Name des Ortes oder Wortanfang für Suchanfragen (name_prefix) aus.

  • GET /locations/zipcode: Gibt eine paginierte Liste von Orten gefiltert nach PLZ oder PLZ-Präfix für Suchanfragen (zipcode_prefix) aus.

Location Group

  • GET /locationgroups: Gibt eine paginierte Liste aller Regionen aus.

  • GET /locationgroups/{group_id}: Gibt die Region aus, gefiltert nach group_id aus.

  • POST /locationgroups: Erstellt eine neue Region mit den im Request Body angegebenen Orte.

  • PUT /locationgroups/{group_id}: Aktualisiert die im Request Body angegebenen Informationen des durch die group_id spezifierten Beitrags.

  • DELETE /locationgroups/{group_id}: Löscht den durch die group_id spezifizierte Region unwiderruflich.

Trouble Shooting bei HTTP Status Codes

400 - Bad Request

404 - Not Found

Verwandte Seiten

 

Nur für PEIQ-Mitarbeiter:innen
https://peiq.atlassian.net/wiki/x/5oWzAg

Impressum