Documentation développeurs

API MKG Move

Intégrez notre tarification instantanée et le statut opérationnel des réservations dans votre produit. Les échanges utilisent REST/JSON et tous les montants monétaires sont exprimés en centimes d'euro.

Base publique: https://mkgmove.com/api
Format: JSON · UTF-8
Devise: EUR

Démarrage

Authentification

Les endpoints partenaires sous /api/v1/* exigent une clé transmise dans l'en-tête X-Api-Key. Les endpoints publics sont accessibles sans clé et limités à 60 requêtes par minute et par adresse IP.

X-Api-Key: votre_cle_partenaire

Protégez votre clé Conservez-la côté serveur. Ne l'intégrez pas dans du JavaScript livré au navigateur ou dans une application publique.

POST

`/api/quote`

Public

Calcule un devis instantané sans enregistrer de réservation.

Paramètres du devis public
Champ	Type	Présence
`category`	`furniture`, `man_and_van` ou `house_move`	Requis
`volume_m3`	Nombre	Requis
`from_postcode` / `to_postcode`	Chaînes	Requis sans `distance_km`
`distance_km`	Nombre	Optionnel
`flexible_date`, `storage`, `long_carry`	Booléens	Optionnels

Exemple de requête

curl -X POST https://mkgmove.com/api/quote \
  -H "Content-Type: application/json" \
  -d '{"category":"furniture","volume_m3":3,"from_postcode":"75011","to_postcode":"75015"}'

Exemple de réponse

{
  "currency": "EUR",
  "distance_km": 12,
  "price_ttc": 101.40,
  "price_ttc_cents": 10140,
  "price_ht_cents": 8450,
  "tva_cents": 1690,
  "needs_survey": false,
  "lines": [{ "label": "Prise en charge", "amount_cents": 3900 }]
}

GET

`/api/addresses?q=`

Public

Renvoie une liste de suggestions d'adresses françaises pour le terme de recherche fourni.

POST

`/api/v1/quote`

Clé requise

Utilise les mêmes paramètres que /api/quote, avec authentification et comptage des appels par partenaire.

GET

`/api/v1/booking/{reference}/status`

Clé requise

Renvoie le statut opérationnel d'une réservation par référence. Aucune donnée personnelle n'est exposée.

curl https://mkgmove.com/api/v1/booking/MKG-ABCD1234/status \
  -H "X-Api-Key: votre_cle_partenaire"

{
  "reference": "MKG-ABCD1234",
  "status": "assigned",
  "status_label": "Transporteur attribué",
  "category": "furniture",
  "scheduled_date": "2026-08-20",
  "transporter_assigned": true,
  "transporter_confirmed": true,
  "from_city": "Paris",
  "to_city": "Lyon",
  "events": [{ "type": "paid", "at": "2026-08-11T09:00:00+00:00" }]
}

Temps réel

Webhooks

Enregistrez une URL auprès de notre équipe pour recevoir les événements de réservation (paid, assigned, en_route, arrived, delivered, completed…). Chaque requête POST est signée avec l'en-tête X-MKG-Signature.

POST https://votre-endpoint.example/hook
X-MKG-Signature: <hmac_sha256(corps_brut, votre_cle_api)>

{ "event": "assigned", "sent_at": "…", "booking": { "reference": "MKG-…", "status": "assigned" } }

Références

Codes de réponse

Codes HTTP renvoyés par l'API
Code	Signification
`200`	Succès
`401`	Clé API manquante ou révoquée
`404`	Ressource introuvable
`422`	Paramètres invalides
`429`	Limite de débit atteinte

Besoin d'une clé partenaire ?

Présentez votre cas d'usage et le volume d'appels prévu à notre équipe.

Contacter l'équipe MKG Move