Aller au contenu
Globe Pickup Points
Ce guide est destiné spécifiquement aux développeurs.

Points de retrait personnalisés via API

Vous pouvez utiliser Globe pour intégrer vos propres points de retrait dans l’application. Cela est particulièrement utile si vous livrez dans vos propres boutiques ou si vous exploitez un réseau de points de retrait personnalisé.

Pour activer les points de retrait personnalisés par vous-même, vous devez configurer une API qui renvoie les données des points de retrait dans un format structuré.

Fonctionnement

Globe envoie une requête POST à votre point de terminaison API lorsqu’un client recherche des points de retrait. Votre API doit renvoyer une liste de points de retrait.

Structure de la requête

  • En-têtes : Content-Type: application/json, X-Origin-Service: Globe Pickup Points
  • Corps :
{
  "latitude": 50.08804,
  "longitude": 14.42076,
  "countryCode": "CZ",
  "shop": "store.myshopify.com"
}

Structure de la réponse

Renvoyez jusqu’à 50 points de retrait triés par distance :

{
  "data": [
    {
      "id": "cz-123456",
      "longitude": 14.42076,
      "latitude": 50.08804,
      "name": "Praha Pickup Point",
      "place": "Retail Store",
      "street": "Na Příkopě 12",
      "city": "Prague",
      "zip": "110 00",
      "country": "CZ",
      "pin": "https://example.com/pin-image.png",
      "openingHours": {
        "monday": "10:00 - 11:00, 12:00 - 15:00",
        "tuesday": "09:00 - 17:00"
      }
    }
  ]
}

Exemple d’implémentation API (Node.js)

const express = require("express");
const app = express();
app.use(express.json());


app.post("/pickup-points", (req, res) => {
  const { latitude, longitude, countryCode, shop } = req.body;
  if (!latitude || !longitude || !countryCode || !shop) {
    return res.status(400).json({ error: "Missing required fields" });
  }
  const pickupPoints = [
    {
      id: "cz-123456",
      longitude: 14.42076,
      latitude: 50.08804,
      name: "Praha Pickup Point",
      place: "Retail Store",
      street: "Na Příkopě 12",
      city: "Prague",
      zip: "110 00",
      country: "CZ",
      openingHours: { monday: "10:00 - 11:00, 12:00 - 15:00" }
    }
  ];
  res.json({ data: pickupPoints });
});


app.listen(3000);

Tester votre API

Fenêtre de terminal
curl -X POST https://your-api.com/pickup-points \
-H "Content-Type: application/json" \
-H "X-Origin-Service: Globe Pickup Points" \
-d '{
  "latitude": 50.08804,
  "longitude": 14.42076,
  "countryCode": "CZ",
  "shop": "store.myshopify.com"
}'

Étapes suivantes

  1. Déployez votre API sur un serveur HTTPS sécurisé.
  2. Ajoutez votre point de terminaison personnalisé dans Globe — ajoutez un nouveau transporteur avec un point de terminaison API personnalisé.
  3. Testez l’intégration pour vérifier que les points de retrait s’affichent correctement.