API pour développeurs

Développeur

Commencez à intégrer en 5 minutes

Obtenez votre clé API, lisez le guide de démarrage rapide et faites votre premier appel. Notre documentation est conçue pour les développeurs sénégalais et africains, avec des exemples concrets adaptés à nos cas d'usage.

Obtenir ma clé API

Démarrage rapide

Trois étapes pour intégrer les adresses Spot dans votre service.

Obtenez votre clé API

Contactez-nous par email avec une présentation de votre service et de votre cas d'usage. Nous vous attribuerons une clé API de test dans les 48 heures.

Faites votre premier appel

Utilisez notre endpoint de vérification pour tester votre intégration. La documentation inclut des exemples en cURL, JavaScript et Python.

Passez en production

Après validation de votre intégration, votre clé passe en production. Nous vous accompagnons avec un support dédié pendant tout le processus.

# Vérifier une adresse Spot
curl -X GET \n  https://api.spot.sn/v1/addresses/SP-7K2M \n  -H "Authorization: Bearer sk_test_votre_cle_api" \
  -H "Content-Type: application/json"

# Réponse
{
  "code": "SP-7K2M",
  "latitude": 14.6937,
  "longitude": -17.4441,
  "quartier": "Grand Yoff",
  "commune": "Dakar",
  "region": "Dakar",
  "verified": true
}

Réponse rapide

Latence moyenne inférieure à 150ms depuis le Sénégal. Nos serveurs sont localisés en Afrique pour garantir des temps de réponse optimaux.

Sécurité intégrée

Authentification par clé API, chiffrement TLS 1.3, rate limiting et logs d'audit. Vos intégrations sont protégées par défaut.

Documentation complète

Guide de démarrage rapide, exemples de code, SDK et référence API complète. Tout ce qu'il faut pour intégrer Spot en quelques heures.

Référence des endpoints

Les principaux endpoints disponibles. La documentation complète est accessible avec votre clé API.

GET/v1/addresses/:code

Récupérer les informations d'une adresse Spot à partir de son code.

{"code": "SP-7K2M", "lat": 14.6937, "lng": -17.4441, "quartier": "Grand Yoff", "commune": "Dakar"}

POST/v1/addresses/verify

Vérifier la validité d'un code d'adresse et obtenir sa localisation.

{"valid": true, "code": "SP-7K2M", "active": true, "created_at": "2026-01-15"}

POST/v1/deliveries/track

Enregistrer le début d'une livraison vers une adresse Spot et suivre sa progression.

{"delivery_id": "del_abc123", "status": "in_progress", "eta_minutes": 25}

GET/v1/addresses/:code/history

Consulter l'historique des partages d'une adresse (avec autorisation).

{"shares": [{"partner": "livreur_express", "date": "2026-03-10", "status": "completed"}]}