Skip to main content

Clé API

Pour vous authentifier, l’en-tête pubrio-api-key doit être inclus. Cet en-tête doit contenir la clé API, par exemple a1b2c3d4e5f6g7h8, qui représente votre clé API.
Vous devez créer une clé API pour accéder à l’API Pubrio. Pour créer une clé API, rendez-vous dans la section Paramètres.
La clé API contient déjà les informations de votre espace de travail (profil) ; vous n’avez donc pas besoin de transmettre profile_id dans le corps de votre requête. Le paramètre profile_id reste accepté pour des raisons de rétrocompatibilité, mais n’est plus obligatoire.

En-têtes de requête

En plus de pubrio-api-key, envoyez un en-tête User-Agent identifiant votre client.
Un User-Agent manquant ou générique est rejeté avant même d’atteindre l’API. Les requêtes sans user agent reconnu sont bloquées en périphérie et renvoient un HTTP 403 avec le corps en texte brut error code: 1010 — pas du JSON, et ce code ne figure pas parmi les codes d’erreur documentés. Cela ressemble à un échec d’authentification, mais ce n’en est pas un : votre clé API est valide.Les user agents par défaut de nombreuses bibliothèques HTTP courantes sont concernés — celui de urllib en Python (Python-urllib/3.x) est bloqué, alors que curl et requests ne le sont pas. Si vous obtenez error code: 1010, définissez un User-Agent explicite et réessayez.