Glossaire

Principaux termes et définitions utilisés dans ANKK APP et ses API, avec des liens vers les guides correspondants.

🏢 Marque (Brand)

L’espace de travail principal qui regroupe les connexions aux réseaux sociaux, les tâches de publication, les membres de l’équipe et les clés API. Chaque clé API est liée à une seule marque.

Guides associés : Créer une marque, API des marques, Équipe et paramètres

🔗 Connexion SNS

Une connexion authentifiée par OAuth ou par identifiants entre une marque et un compte de réseau social externe. Elle est identifiée par un connection_id.

Guides associés : Connecter des comptes SNS, API des connexions, Capacités des SNS

📝 Contenu (Content)

Une unité de publication logique ciblant une connexion SNS spécifique, contenant le texte du corps, les médias, les hashtags, l’heure de programmation et les paramètres de la plateforme.

Guides associés : Composer du contenu, API des contenus

⚙️ Tâche de publication (Publish Job)

Un enregistrement d’exécution asynchrone en arrière-plan qui permet de suivre la livraison d’un contenu au réseau social de destination.

Guides associés : File d’attente et statut de publication, Échecs et nouvelles tentatives

📥 Contenu créé et contenu synchronisé

Contenu créé : Publications créées et programmées dans ANKK APP. Elles peuvent être relancées en cas d’échec et modifiées tant qu’elles sont dans la file d’attente.
Contenu synchronisé : Publications historiques synchronisées depuis des comptes externes. Elles sont en lecture seule et ne peuvent être ni modifiées ni relancées dans ANKK.
Guides associés : Contenu publié

⏳ Requête acceptée (HTTP 202 Accepted)

Indique que la requête a passé l’authentification, la vérification des quotas et la validation de la charge utile, puis a été placée dans la file d’attente. Cela ne confirme pas encore sa publication (published).

Guides associés : File d’attente et statut de publication, Webhooks

🔑 Clé d’idempotence (Idempotency Key)

Un jeton unique fourni par le client qui garantit la sécurité des nouvelles tentatives sans risquer de publications en double sur les réseaux sociaux externes.

Guides associés : Gestion des erreurs, API des contenus

⚠️ Reconnexion requise vs Action utilisateur requise

Reconnexion requise : Jeton expiré ou autorisations révoquées ; nécessite une réauthentification OAuth.
Action utilisateur requise : Action nécessaire directement dans l’application de la plateforme externe (ex: acceptation de nouvelles conditions).
Guides associés : Échecs et nouvelles tentatives, Connecter les SNS

🔔 Webhook

Un événement HTTP POST en temps réel signé par HMAC SHA256, livré à votre point de terminaison à la fin d’une tâche.

Guides associés : Référence des Webhooks