Migration MyDHL API Version obsolète → Version RESTFUL (V2)

Guide officiel pour la continuité de vos services d'expédition avant fin 2026.

Diagnostic Rapide

Êtes-vous concerné ?

Pour identifier les endpoints à remplacer, recherchez la présence du domaine de base suivant dans l'intégralité de votre code source (Production ET Test/Sandbox) :

https://wsbexpress.dhl.com

Ce domaine héberge tous les endpoints v1 obsolètes listés ci-dessous.

Liste des endpoints impactés :

Endpoint (v1) Description Statut
/rest/gbl/ShipmentRequest Création d'expédition Arrêt Définitif
/rest/gbl/RateRequest Demande de tarifs Arrêt Définitif
/rest/gbl/TrackingRequest Suivi de colis Arrêt Définitif
/rest/gbl/addressValidate Validation d'adresse Arrêt Définitif
/rest/gbl/getePOD Preuve de livraison (ePOD) Arrêt Définitif

Utilisateurs de logiciels tiers (Magento, Shopify, ERP...) : Si vous n'avez pas accès au code source mais que vous utilisez ces services, transmettez ce guide à votre éditeur logiciel.

Documentation & Accès

Référence API (Swagger)

Liste exhaustive des URLs, paramètres et modèles JSON pour l'API v2.

Portail Développeur

Créez vos clés API v2 et accédez à l'environnement de test.

Aperçu d'Implémentation

Ancienne version (v1) Obsolète 
POST https://wsbexpress.dhl.com/rest/gbl/ShipmentRequest

{
  "ShipmentRequest": {
    "RequestedShipment": {
      "ShipmentInfo": {
        "ServiceType": "P"
      },
      "Ship": { ... }
    }
  }
}
Nouvelle version (v2) ✓ Standard 
POST https://api.dhl.com/mydhlapi/shipments
Authorization: Basic base64(key:secret)

{
  "productCode": "P",
  "accounts": [
    { "number": "123456789", "typeCode": "shipper" }
  ],
  "customerDetails": { ... },
  "content": { ... }
}
Source v1 Cible v2 Action
ServiceTypeproductCodeRenommer
Accountaccounts[].numberTableau d'objets
Packagescontent.packagesSous "content"
✓

Réponse de succès (201 Created)

  • 📄 Numéro de suivi : shipmentTrackingNumber
  • 📦 Étiquette PDF : tableau documents (Base64)
  • 🔗 URL de suivi : tableau links

Attention aux environnements de test

Les endpoints de test contenant /rest/sndpt/... seront également désactivés. Pensez à migrer vos environnements de staging.

🔍 Exemples de Codes HTTP

201
Succès (Created)
400
Bad Request
401
Unauthorized
500
Server Error

Besoin d'aide pour la migration ?

La date limite de fin de service est le 31 Juin 2026.
Pour toute question technique spécifique à l'arrêt de ces endpoints :

Formulaire de demande d'assistance technique