rssLink RSS for all categories
 
icon_blue
icon_green
icon_blue
icon_red
icon_green
icon_green
icon_green
icon_orange
icon_green
icon_red
icon_green
icon_green
icon_green
icon_blue
icon_green
icon_red
icon_blue
icon_orange
icon_orange
icon_green
icon_green
icon_green
icon_green
icon_green
icon_orange
icon_green
icon_green
icon_green
icon_green
icon_green
icon_green
icon_orange
icon_green
icon_green
icon_green
icon_green
 

FS#51417 — API - charset encoding in URI / API - encodage des caractères dans l'URI

Attached to Project— Corporate Website
Amélioration
Backend / Core
CLOSED
100%
Hello,

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.

Example:
GET https://api.ovh.com/1.0/me/sshKey/Hervé
used to be encoded in ISO-8859-1 as:
GET https://api.ovh.com/1.0/me/sshKey/Herv%E9
should be encoded in UTF-8, as:
GET https://api.ovh.com/1.0/me/sshKey/Herv%C3%A9

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.

Exemple:

GET https://api.ovh.com/1.0/me/sshKey/Hervé
encodé avec l'ancien format ISO-8859-1 générait cette requête:
GET https://api.ovh.com/1.0/me/sshKey/Herv%E9
désormais, encodé au format UTF-8, générera cette requête:
GET https://api.ovh.com/1.0/me/sshKey/Herv%C3%A9

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)

Date:  Saturday, 30 October 2021, 16:33PM
Reason for closing:  Done