Authentification de l’API — API/SDK avancé
Utilisez les clés serveur propres à chaque produit pour les requêtes API/SDK avancées ; Stripe automatique n’en nécessite aucune.
Mis à jour le August 3, 2026
Ces identifiants concernent uniquement le mode API/SDK avancé. Stripe automatique ne nécessite ni clé API produit ni clé d’empreinte ; AffiHQ gère ses livraisons Stripe connectées. Pour le mode API/SDK avancé, l’URL de base de l’API est https://affihq.com/api/v1 et chaque requête utilise HTTPS ainsi qu’une clé serveur propre au produit.
Authorization: Bearer ahq_sk_xxx
Accept: application/json
Content-Type: application/json
N’exposez jamais la clé dans le JavaScript du navigateur, une application mobile, une URL ou un log. En cas de compromission, renouvelez-la depuis le panneau d’intégration du produit.
/api/v1/integrationVérifie la clé et renvoie le produit, la version de l’API et les capacités prises en charge, sans donnée financière.
Appelez ce point d’entrée dans le parcours API/SDK avancé pour vérifier les identifiants avant d’envoyer des événements client ou financiers. Testez ensuite séparément l’attribution et la facturation.
Identifiants de requête
AffiHQ renvoie un en-tête X-Request-Id. Conservez-le avec les informations de diagnostic sans donnée sensible afin que le support retrouve un échec. N’ajoutez aux logs ni corps de requête, ni référence brute, ni identifiant client, ni empreinte, ni clé.
Réponses
Une réponse réussie place sa valeur dans data. Une erreur contient un code stable, un message sans donnée sensible, retryable et requestId.
Retentez uniquement les erreurs signalées comme temporaires. Les limites de débit et erreurs serveur peuvent être retentées ; un rejet métier 4xx stable rejoint votre suivi d’incidents ou vos messages rejetés.