Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

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

Expand
titleInhaltsverzeichnis anzeigen
Table of Contents
maxLevel4

Grundlegendes zur Location API

Die Location API ist der API Endpunkt zum Auslesen der Ortsstruktur. Über die unten genannten Endpunkte können die im PORTAL vorliegenden Orte nach verschiedenen Filtern abgerufen werden.

Verfügbare Endpunkte

Status
colourBlue
titleGET

  • All Locations

    • location_ids

  • All Locations by Coordinate Filter

    • lat (Latitude)

    • lng (Longitude)

  • All Locations by Name Filter

    • name_norm

    • name

    • name_prefix

  • All Locations by Zipcode Filter

    • zipcode

    • zipcode_prefix

Für die Anzahl der Ergebnisse kann ein Limit gesetzt werden.

Response

Code Block
languagejson
[
  {
    "id": "1",
    "name": "Augsburg",
    "name_norm": "augsburg",
    "lat": "41.4123541",
    "lng": "10.213123412"
  }
]

HTTP Status Codes

Code Block
languagehtml
200 - Success Alles hat wie erwartet funktioniert 400 - Bad Request Der Request war nicht akzeptabel. Das liegt oft an einem fehlenden Parameter. Checken Sie hierfür den gesendeten Request Body. 404 - Location Not Found

Trouble Shooting bei HTTP Status Codes

400 - Bad Request

Insert excerpt
API 2.0 Dokumentation PORTAL
API 2.0 Dokumentation PORTAL
name400
nopaneltrue

404 - Not Found

Insert excerpt
API 2.0 Dokumentation PORTAL
API 2.0 Dokumentation PORTAL
name404
nopaneltrue

Verwandte Seiten

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
cqllabel in ( "api" , "api-dokumentation" ) and space = "PPSD"
Include Page
Disclaimer der PEIQ PORTAL - Produktdokumentation
Disclaimer der PEIQ PORTAL - Produktdokumentation