Eigene Abholpunkte über die API

Mit der Globe API können Sie Ihr eigenes Abholpunktnetzwerk integrieren. So können Sie benutzerdefinierte Abholpunkte direkt über eine API bereitstellen und diese zusammen mit den von Globe unterstützten Spediteuren anbieten.

---

Übersicht

Die API für eigene Abholpunkte ermöglicht es Ihnen:

• Eigene Abholpunkte aus einer externen Datenquelle bereitzustellen
• Abholpunkte dynamisch basierend auf der Kundenadresse zu filtern
• Vollständige Kontrolle über Abholpunktdaten und ihre Anzeige zu behalten

---

Authentifizierung

Alle API-Anfragen müssen mit Ihrem Globe API-Schlüssel authentifiziert werden. Fügen Sie den Schlüssel als HTTP-Header ein:

Authorization: Bearer YOUR_API_KEY

---

Endpunkt: Abholpunkte abrufen

Globe ruft Ihre Abholpunkte über einen von Ihnen konfigurierten Endpunkt ab. Der Endpunkt muss eine Liste von Abholpunkten im folgenden JSON-Format zurückgeben.

Anfrage

Globe sendet eine GET-Anfrage an Ihren Endpunkt mit folgenden Abfrageparametern:

GET https://your-endpoint.example.com/pickup-points?lat=50.0755&lng=14.4378&limit=20

Parameter	Typ	Beschreibung
lat	number	Breitengrad der Kundenadresse
lng	number	Längengrad der Kundenadresse
limit	number	Maximale Anzahl zurückzugebender Abholpunkte

Antwort

Ihr Endpunkt muss eine JSON-Antwort mit folgendem Format zurückgeben:

{
  "points": [
    {
      "id": "point-123",
      "name": "Mein Abholpunkt Wien",
      "latitude": 48.2082,
      "longitude": 16.3738,
      "address": {
        "street": "Hauptstraße 1",
        "city": "Wien",
        "zip": "1010",
        "country": "AT"
      },
      "openingHours": [
        { "day": "monday", "open": "09:00", "close": "18:00" },
        { "day": "tuesday", "open": "09:00", "close": "18:00" },
        { "day": "wednesday", "open": "09:00", "close": "18:00" },
        { "day": "thursday", "open": "09:00", "close": "18:00" },
        { "day": "friday", "open": "09:00", "close": "17:00" },
        { "day": "saturday", "open": "10:00", "close": "14:00" }
      ]
    }
  ]
}

---

Datenfelder

Pflichtfelder

Feld	Typ	Beschreibung
id	string	Eindeutige Kennung des Abholpunkts
name	string	Name des Abholpunkts
latitude	number	Breitengrad des Abholpunkts
longitude	number	Längengrad des Abholpunkts
address.street	string	Straße und Hausnummer
address.city	string	Stadt
address.zip	string	Postleitzahl
address.country	string	Ländercode (ISO 3166-1 alpha-2)

Optionale Felder

Feld	Typ	Beschreibung
openingHours	array	Öffnungszeiten nach Wochentag
description	string	Zusätzliche Beschreibung des Abholpunkts
photoUrl	string	URL zu einem Bild des Abholpunkts
maxParcelWeight	number	Maximales Paketgewicht in kg
maxParcelSize	string	Maximale Paketgröße

---

Integration einrichten

Schritt 1 — Eigenen Anbieter erstellen

1. Öffnen Sie Globe Pickup Points in Ihrer Shopify-Verwaltung.
2. Klicken Sie auf Spediteur hinzufügen.
3. Wählen Sie Eigene Abholpunkte aus der Liste.

Schritt 2 — Endpunkt konfigurieren

// Beispiel: Express.js-Endpunkt für eigene Abholpunkte
app.get('/pickup-points', async (req, res) => {
  const { lat, lng, limit = 20 } = req.query;

  // Nächstgelegene Abholpunkte aus Ihrer Datenbank abrufen
  const points = await getPickupPointsNearby(
    parseFloat(lat),
    parseFloat(lng),
    parseInt(limit)
  );

  res.json({ points });
});

Schritt 3 — Endpunkt-URL in Globe eingeben

1. Geben Sie die URL Ihres Endpunkts in die Globe-Einstellungen ein.
2. Geben Sie optional einen API-Schlüssel für die Authentifizierung an.
3. Speichern Sie die Einstellungen und testen Sie die Verbindung.

---

Testen der Integration

Mit curl können Sie Ihren Endpunkt testen:

curl -X GET "https://your-endpoint.example.com/pickup-points?lat=50.0755&lng=14.4378&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

---

Fehlerbehebung

Problem	Lösung
Abholpunkte werden nicht angezeigt	Überprüfen Sie, ob Ihr Endpunkt erreichbar ist und das korrekte JSON-Format zurückgibt
Authentifizierungsfehler	Überprüfen Sie den API-Schlüssel in Ihren Globe-Einstellungen
Ungültige Koordinaten	Stellen Sie sicher, dass Breiten- und Längengrade als Dezimalzahlen übergeben werden
Zeitüberschreitung	Ihr Endpunkt sollte innerhalb von 3 Sekunden antworten

---

Hinweise für Entwickler

• Ihr Endpunkt muss HTTPS verwenden.
• Die Antwortzeit sollte unter 3 Sekunden liegen, um ein gutes Kundenerlebnis zu gewährleisten.
• Globe speichert die Abholpunkte für eine begrenzte Zeit zwischen – berücksichtigen Sie dies bei häufigen Datenänderungen.
• Für Fragen zur API stehen unsere Entwickler über den Support-Chat zur Verfügung.