Notes de version

Les API de Postes Canada changent et évoluent souvent au fil du temps. Par exemple, de nouveaux services ou de nouvelles options peuvent être ajoutés, d’anciens produits peuvent être retirés et des bogues peuvent être corrigés. Ces modifications nécessitent un changement du numéro de version de l’API. Dans certains cas, la mise à niveau vers la nouvelle version est facultative, tandis que d’autres API nécessitent une mise à niveau obligatoire. Nous vous informerons en avance par courriel de toute nouvelle caractéristique ou version. Les anciennes versions de nos API seront prises en charge aussi longtemps que possible. Nous vous donnerons un préavis suffisant si une version doit être retirée.

Catégories API

Diagramme montrant la version du produit d’API. Le diagramme montre le nom de la version de l’API d’expédition et fournit des explications pour chaque partie du numéro de version.

Nos API sont regroupées en catégories appelées produits d’API (p. ex., tarification, repérage, expédition). Les versions des produits d’API sont indiquées par un nom de version unique pour tous les groupes de produits d’API (par exemple, tarification 4.0.0 ou tarification 3.1.0). Une version initiale (1.0.0) a été attribuée à chaque produit d’API au départ, et chaque produit d’API a une version indépendante. Vos applications doivent utiliser la même version de chaque API de Postes Canada lorsqu’elles appellent une API du même groupe (par exemple, toutes vos applications doivent appeler la version tarification 4.0.0 si c’est celle que vous avez choisie).

Version REST

Les renseignements sur la version sont transmis de façon dynamique à nos API dans les variables d’en-tête HTTP Content-Type ou Accept (voir variables d’en-tête HTTP). Les renseignements sur la version sont retournés de façon dynamique à partir de nos API dans l’attribut media-type des éléments de lien. Par exemple :

Valeurs d’en-tête de l’API de tarification
Variable des en-têtes HTTP	Valeur d’en-tête
Accept	application/vnd.cpc.ship.rate-v4+xml
Content-Type	application/vnd.cpc.ship.rate-v4+xml

Important

Si, par le passé, vos demandes REST à nos API utilisaient */* au lieu de l’en-tête Accept, sachez que nous ne prenons plus en charge ces demandes (depuis le 21 septembre 2013). Vous devez indiquer une valeur pour vos variables Accept et Content-Type dans votre en-tête HTTP.

État de la version, historique et notes de version

Tarification

Tarification
Version	Notes de mise à jour
4.0.0 Pris en charge	30 avril 2026 Nouvelle fonctionnalité Normalisation du format JSON Tous les points de terminaison des API utilisent maintenant le format JSON pour les demandes et les réponses, ce qui assure la parité complète des fonctionnalités avec les formats précédents. Cela assure l’uniformité et simplifie l’intégration. Simplification du protocole (REST seulement) Nous avons simplifié notre soutien du protocole, c’est pourquoi le REST est la seule option disponible. XML n’est plus pris en charge SOAP n’est plus pris en charge Augmentation du soutien en matière de langages Nous avons considérablement élargi notre soutien aux langages de programmation suivants : Python Ruby cURL PHP Java Node.js Go Swift C C# Fichiers de configuration YAML disponibles Nous offrons maintenant les fichiers YAML pour faciliter la configuration et le déploiement des clients API. Ces fichiers conviennent particulièrement aux mises en œuvre automatisées. Remarque : Si votre intégration actuelle utilise XML ou SOAP, vous devrez passer au format JSON/REST pour accéder aux dernières versions de nos API. Veuillez consulter notre documentation mise à jour de l’API pour obtenir des guides de migration et des exemples de nouveaux codes. Mise à jour de sécurité Jetons OAuth 2.0 Bearer obligatoires Chaque demande de l’API doit maintenant inclure un jeton d’accès OAuth 2.0 Bearer valide dans l’en-tête d’autorisation. Cela améliore la sécurité et assure la conformité aux normes modernes. Consultez nos documents mis à jour pour obtenir des précisions et des guides de mise en œuvre. Changement important L’inscription des commerces a été mise hors service en tant que point de terminaison d’API. Si votre application est intégrée directement à l’API d’inscription des commerces, vous devez maintenant utiliser la méthode alternative désignée pour l’inscription des commerces.

Expédition

Expédition
Version	Notes de mise à jour
8.0.0 Pris en charge	30 avril 2026 Nouvelle fonctionnalité Normalisation du format JSON Tous les points de terminaison des API utilisent maintenant le format JSON pour les demandes et les réponses, ce qui assure la parité complète des fonctionnalités avec les formats précédents. Cela assure l’uniformité et simplifie l’intégration. Simplification du protocole (REST seulement) Nous avons simplifié notre soutien du protocole, c’est pourquoi le REST est la seule option disponible. XML n’est plus pris en charge SOAP n’est plus pris en charge Augmentation du soutien en matière de langages Nous avons considérablement élargi notre soutien aux langages de programmation suivants : Python Ruby cURL PHP Java Node.js Go Swift C C# Fichiers de configuration YAML disponibles Nous offrons maintenant les fichiers YAML pour faciliter la configuration et le déploiement des clients API. Ces fichiers conviennent particulièrement aux mises en œuvre automatisées. Remarque : Si votre intégration actuelle utilise XML ou SOAP, vous devrez passer au format JSON/REST pour accéder aux dernières versions de nos API. Veuillez consulter notre documentation mise à jour de l’API pour obtenir des guides de migration et des exemples de nouveaux codes. Mise à jour de sécurité Jetons OAuth 2.0 Bearer obligatoires Chaque demande de l’API doit maintenant inclure un jeton d’accès OAuth 2.0 Bearer valide dans l’en-tête d’autorisation. Cela améliore la sécurité et assure la conformité aux normes modernes. Consultez nos documents mis à jour pour obtenir des précisions et des guides de mise en œuvre. Changement important L’inscription des commerces a été mise hors service en tant que point de terminaison d’API. Si votre application est intégrée directement à l’API d’inscription des commerces, vous devez maintenant utiliser la méthode alternative désignée pour l’inscription des commerces.

Repérage

Repérage
Version	Notes de mise à jour
2.0.0 Pris en charge	30 avril 2026 Nouvelle fonctionnalité Normalisation du format JSON Tous les points de terminaison des API utilisent maintenant le format JSON pour les demandes et les réponses, ce qui assure la parité complète des fonctionnalités avec les formats précédents. Cela assure l’uniformité et simplifie l’intégration. Simplification du protocole (REST seulement) Nous avons simplifié notre soutien du protocole, c’est pourquoi le REST est la seule option disponible. XML n’est plus pris en charge SOAP n’est plus pris en charge Augmentation du soutien en matière de langages Nous avons considérablement élargi notre soutien aux langages de programmation suivants : Python Ruby cURL PHP Java Node.js Go Swift C C# Fichiers de configuration YAML disponibles Nous offrons maintenant les fichiers YAML pour faciliter la configuration et le déploiement des clients API. Ces fichiers conviennent particulièrement aux mises en œuvre automatisées. Remarque : Si votre intégration actuelle utilise XML ou SOAP, vous devrez passer au format JSON/REST pour accéder aux dernières versions de nos API. Veuillez consulter notre documentation mise à jour de l’API pour obtenir des guides de migration et des exemples de nouveaux codes. Mise à jour de sécurité Jetons OAuth 2.0 Bearer obligatoires Chaque demande de l’API doit maintenant inclure un jeton d’accès OAuth 2.0 Bearer valide dans l’en-tête d’autorisation. Cela améliore la sécurité et assure la conformité aux normes modernes. Consultez nos documents mis à jour pour obtenir des précisions et des guides de mise en œuvre. Changement important L’inscription des commerces a été mise hors service en tant que point de terminaison d’API. Si votre application est intégrée directement à l’API d’inscription des commerces, vous devez maintenant utiliser la méthode alternative désignée pour l’inscription des commerces.

Services de bureau de poste

Services de bureau de poste
Version	Notes de mise à jour
1.0.0 Pris en charge	30 avril 2026 Nouvelle fonctionnalité Normalisation du format JSON Tous les points de terminaison des API utilisent maintenant le format JSON pour les demandes et les réponses, ce qui assure la parité complète des fonctionnalités avec les formats précédents. Cela assure l’uniformité et simplifie l’intégration. Simplification du protocole (REST seulement) Nous avons simplifié notre soutien du protocole, c’est pourquoi le REST est la seule option disponible. XML n’est plus pris en charge SOAP n’est plus pris en charge Augmentation du soutien en matière de langages Nous avons considérablement élargi notre soutien aux langages de programmation suivants : Python Ruby cURL PHP Java Node.js Go Swift C C# Fichiers de configuration YAML disponibles Nous offrons maintenant les fichiers YAML pour faciliter la configuration et le déploiement des clients API. Ces fichiers conviennent particulièrement aux mises en œuvre automatisées. Remarque : Si votre intégration actuelle utilise XML ou SOAP, vous devrez passer au format JSON/REST pour accéder aux dernières versions de nos API. Veuillez consulter notre documentation mise à jour de l’API pour obtenir des guides de migration et des exemples de nouveaux codes. Mise à jour de sécurité Jetons OAuth 2.0 Bearer obligatoires Chaque demande de l’API doit maintenant inclure un jeton d’accès OAuth 2.0 Bearer valide dans l’en-tête d’autorisation. Cela améliore la sécurité et assure la conformité aux normes modernes. Consultez nos documents mis à jour pour obtenir des précisions et des guides de mise en œuvre. Changement important L’inscription des commerces a été mise hors service en tant que point de terminaison d’API. Si votre application est intégrée directement à l’API d’inscription des commerces, vous devez maintenant utiliser la méthode alternative désignée pour l’inscription des commerces.

Ramassage

Ramassage
Version	Notes de mise à jour
1.0.0 Pris en charge	30 avril 2026 Nouvelle fonctionnalité Normalisation du format JSON Tous les points de terminaison des API utilisent maintenant le format JSON pour les demandes et les réponses, ce qui assure la parité complète des fonctionnalités avec les formats précédents. Cela assure l’uniformité et simplifie l’intégration. Simplification du protocole (REST seulement) Nous avons simplifié notre soutien du protocole, c’est pourquoi le REST est la seule option disponible. XML n’est plus pris en charge SOAP n’est plus pris en charge Augmentation du soutien en matière de langages Nous avons considérablement élargi notre soutien aux langages de programmation suivants : Python Ruby cURL PHP Java Node.js Go Swift C C# Fichiers de configuration YAML disponibles Nous offrons maintenant les fichiers YAML pour faciliter la configuration et le déploiement des clients API. Ces fichiers conviennent particulièrement aux mises en œuvre automatisées. Remarque : Si votre intégration actuelle utilise XML ou SOAP, vous devrez passer au format JSON/REST pour accéder aux dernières versions de nos API. Veuillez consulter notre documentation mise à jour de l’API pour obtenir des guides de migration et des exemples de nouveaux codes. Mise à jour de sécurité Jetons OAuth 2.0 Bearer obligatoires Chaque demande de l’API doit maintenant inclure un jeton d’accès OAuth 2.0 Bearer valide dans l’en-tête d’autorisation. Cela améliore la sécurité et assure la conformité aux normes modernes. Consultez nos documents mis à jour pour obtenir des précisions et des guides de mise en œuvre. Changement important L’inscription des commerces a été mise hors service en tant que point de terminaison d’API. Si votre application est intégrée directement à l’API d’inscription des commerces, vous devez maintenant utiliser la méthode alternative désignée pour l’inscription des commerces.

Retours

Retours
Version	Notes de mise à jour
2.0.0 Pris en charge	30 avril 2026 Nouvelle fonctionnalité Normalisation du format JSON Tous les points de terminaison des API utilisent maintenant le format JSON pour les demandes et les réponses, ce qui assure la parité complète des fonctionnalités avec les formats précédents. Cela assure l’uniformité et simplifie l’intégration. Simplification du protocole (REST seulement) Nous avons simplifié notre soutien du protocole, c’est pourquoi le REST est la seule option disponible. XML n’est plus pris en charge SOAP n’est plus pris en charge Augmentation du soutien en matière de langages Nous avons considérablement élargi notre soutien aux langages de programmation suivants : Python Ruby cURL PHP Java Node.js Go Swift C C# Fichiers de configuration YAML disponibles Nous offrons maintenant les fichiers YAML pour faciliter la configuration et le déploiement des clients API. Ces fichiers conviennent particulièrement aux mises en œuvre automatisées. Remarque : Si votre intégration actuelle utilise XML ou SOAP, vous devrez passer au format JSON/REST pour accéder aux dernières versions de nos API. Veuillez consulter notre documentation mise à jour de l’API pour obtenir des guides de migration et des exemples de nouveaux codes. Mise à jour de sécurité Jetons OAuth 2.0 Bearer obligatoires Chaque demande de l’API doit maintenant inclure un jeton d’accès OAuth 2.0 Bearer valide dans l’en-tête d’autorisation. Cela améliore la sécurité et assure la conformité aux normes modernes. Consultez nos documents mis à jour pour obtenir des précisions et des guides de mise en œuvre. Changement important L’inscription des commerces a été mise hors service en tant que point de terminaison d’API. Si votre application est intégrée directement à l’API d’inscription des commerces, vous devez maintenant utiliser la méthode alternative désignée pour l’inscription des commerces.

Renseignements sur le service

Renseignements sur le service
Version	Notes de mise à jour
2.0.0 Pris en charge	30 avril 2026 Nouvelle fonctionnalité Normalisation du format JSON Tous les points de terminaison des API utilisent maintenant le format JSON pour les demandes et les réponses, ce qui assure la parité complète des fonctionnalités avec les formats précédents. Cela assure l’uniformité et simplifie l’intégration. Simplification du protocole (REST seulement) Nous avons simplifié notre soutien du protocole, c’est pourquoi le REST est la seule option disponible. XML n’est plus pris en charge SOAP n’est plus pris en charge Augmentation du soutien en matière de langages Nous avons considérablement élargi notre soutien aux langages de programmation suivants : Python Ruby cURL PHP Java Node.js Go Swift C C# Fichiers de configuration YAML disponibles Nous offrons maintenant les fichiers YAML pour faciliter la configuration et le déploiement des clients API. Ces fichiers conviennent particulièrement aux mises en œuvre automatisées. Remarque : Si votre intégration actuelle utilise XML ou SOAP, vous devrez passer au format JSON/REST pour accéder aux dernières versions de nos API. Veuillez consulter notre documentation mise à jour de l’API pour obtenir des guides de migration et des exemples de nouveaux codes. Mise à jour de sécurité Jetons OAuth 2.0 Bearer obligatoires Chaque demande de l’API doit maintenant inclure un jeton d’accès OAuth 2.0 Bearer valide dans l’en-tête d’autorisation. Cela améliore la sécurité et assure la conformité aux normes modernes. Consultez nos documents mis à jour pour obtenir des précisions et des guides de mise en œuvre. Changement important L’inscription des commerces a été mise hors service en tant que point de terminaison d’API. Si votre application est intégrée directement à l’API d’inscription des commerces, vous devez maintenant utiliser la méthode alternative désignée pour l’inscription des commerces.

Services d’information sur les clients

Services d’information sur les clients
Version	Notes de mise à jour
2.0.0 Pris en charge	30 avril 2026 Nouvelle fonctionnalité Normalisation du format JSON Tous les points de terminaison des API utilisent maintenant le format JSON pour les demandes et les réponses, ce qui assure la parité complète des fonctionnalités avec les formats précédents. Cela assure l’uniformité et simplifie l’intégration. Simplification du protocole (REST seulement) Nous avons simplifié notre soutien du protocole, c’est pourquoi le REST est la seule option disponible. XML n’est plus pris en charge SOAP n’est plus pris en charge Augmentation du soutien en matière de langages Nous avons considérablement élargi notre soutien aux langages de programmation suivants : Python Ruby cURL PHP Java Node.js Go Swift C C# Fichiers de configuration YAML disponibles Nous offrons maintenant les fichiers YAML pour faciliter la configuration et le déploiement des clients API. Ces fichiers conviennent particulièrement aux mises en œuvre automatisées. Remarque : Si votre intégration actuelle utilise XML ou SOAP, vous devrez passer au format JSON/REST pour accéder aux dernières versions de nos API. Veuillez consulter notre documentation mise à jour de l’API pour obtenir des guides de migration et des exemples de nouveaux codes. Mise à jour de sécurité Jetons OAuth 2.0 Bearer obligatoires Chaque demande de l’API doit maintenant inclure un jeton d’accès OAuth 2.0 Bearer valide dans l’en-tête d’autorisation. Cela améliore la sécurité et assure la conformité aux normes modernes. Consultez nos documents mis à jour pour obtenir des précisions et des guides de mise en œuvre. Changement important L’inscription des commerces a été mise hors service en tant que point de terminaison d’API. Si votre application est intégrée directement à l’API d’inscription des commerces, vous devez maintenant utiliser la méthode alternative désignée pour l’inscription des commerces.

Catégories API