On September 14th, we will perform a modification on the way API OVH handles the charset in URI.
If you use the API to calls some routes containing non-ASCII characters,
cf RFC3986 section 2 https://datatracker.ietf.org/doc/html/rfc3986#section-2,
characters needs to be URI-encoded.
Current version of the OVHcloud API allows characters to be encoded using
ISO-8859-1 charset.
To prepare future version of the API, and permit a more standard way to use the API,
we will switch to UTF-8 charset for URI encoding, and therefore, all calls
with characters encoded in ISO-8859-1 will be incorrectly processed.
On September 14th 2021, all API calls including special characters performed on:
- api.ovh.com
- eu.api.ovh.com
- ca.api.ovh.com
- api.us.ovhcloud.com
- eu.api.soyoustart.com
- ca.api.soyoustart.com
- eu.api.kimsufi.com
- ca.api.kimsufi.com
will need to be UTF-8 encoded, instead of using Latin 1 (ISO-8859-1) encoding.
Please make sure your API client generates UTF-8 charset encoding.
More informations can be asked on the API mailing list, api@ml.ovh.net (to subscribe to the mailing-list, please send an email to api-subscribe@ml.ovh.net)
---
Bonjour,
Le mardi 14 septembre 2021, nous effectuerons une modification sur la gestion de l'encodage des URI de l'API OVH.
Si vous utilisez l'API d'OVHcloud sur des routes contenant des caractères
non-ASCII, cf la RFC3986 section 2 https://datatracker.ietf.org/doc/html/rfc3986#section-2,
ces caractères nécessitent d'être URL-encodés.
La version actuelle de l'API OVHcloud autorise l'encodage des caractères au format Latin1, aussi
connu sous le nom de ISO-8859-1.
Pour préparer les futures évolutions de l'API, et permettre un usage plus standard de l'API,
nous allons changer l'encodage utilisé pour les URI: le nouvel encodage sera UTF-8.
De ce fait, tous les appels dont les URIs possèdent des caractères encodés en ISO-8859-1
ne seront plus gérés correctement, et pourront produire des erreurs.
Le 14 septembre 2021, tous les appels d'API incluant des caractères non-ASCII sur les URLs suivantes:
- api.ovh.com
- eu.api.ovh.com
- ca.api.ovh.com
- api.us.ovhcloud.com
- eu.api.soyoustart.com
- ca.api.soyoustart.com
- eu.api.kimsufi.com
- ca.api.kimsufi.com
nécessiteront d'être encodés au format UTF-8.
Merci de vous assurer que vos clients d'API gère l'encodage des caractères en UTF-8.
Plus d'informations pourra être demandé sur la liste de diffusion api@ml.ovh.net (pour s'abonner à la liste de diffusion, envoyez un email à api-subscribe@ml.ovh.net)
Posted Jun 16, 2021 - 16:51 UTC
This scheduled maintenance affected: Corporate websites || Corporate websites.