Aller au contenu
AfriContext
Publier un contexte

AfriContext Spec

Un format, toujours le même. Les sections sont au même endroit sur chaque fiche, le formulaire le vérifie à la soumission, et un éditeur d'API pourra un jour certifier ses propres contextes.

L'en-tête

1slug: wave-checkout-api2title: Wave - API Checkout3type: cursorrules          # cursorrules | claude_prompt | mcp_server4service: Wave5pays: [SN, CI]6category: paiement7version_api: v18source_url: https://docs.wave.com/checkout9tested_with: [cursor, claude-code]10last_verified_at: 2026-10-1211tags: [fintech, paiement-mobile]
source_url
Obligatoire. Une URL HTTPS de la documentation officielle. Sans elle, le formulaire refuse le contexte.
pays
Codes ISO des pays couverts, ou GLOBAL pour une API disponible dans le monde entier.
category
Paiement, SMS, communication, commerce, identité, données, infrastructure, outillage ou autre API.
type
cursorrules, claude_prompt ou mcp_server. Rien d'autre.
last_verified_at
La date affichée sur le tampon de la fiche. La veille la remet en question si la doc change.
tested_with
Les outils avec lesquels la preuve avant / après a été produite.

Les huit sections, dans cet ordre

  1. 1

    Authentification

    Méthode et en-têtes, sans aucune valeur secrète

  2. 2

    Endpoints

    Méthode, chemin, champs requis et optionnels

  3. 3

    Erreurs

    Codes de retour et comportement attendu

  4. 4

    Webhooks

    Format du payload et vérification de signature

  5. 5

    Idempotence et limites

    Clés d'idempotence et limites de débit

  6. 6

    Pièges courants

    Ce que les LLMs inventent pour ce service

  7. 7

    Exemple minimal

    Exemple complet et typé

  8. 8

    Variables d'environnement

    Noms uniquement

La section Pièges courants est celle qui fait la différence : elle dit à l'IA, noir sur blanc, ce qu'elle a l'habitude d'inventer pour ce service.

Règles de validation

  • Toutes les sections sont présentes et non vides.
  • Aucun secret : motifs sk_ et pk_, Bearer suivi d'un jeton, JWT, clés PEM, valeurs longues assignées à une clé.
  • La section Variables d'environnement ne contient que des noms.
  • Le rendu n'accepte aucun HTML brut : le Markdown est affiché comme du texte.
  • Chaque contexte reste en attente jusqu'à la validation d'un administrateur.

Installer depuis le terminal

La CLI installe chaque contexte comme Skill indépendante, détectée par VS Code / Copilot et Antigravity, dans .agents/skills/<slug>/SKILL.md.

$npx africontext add wave-checkout-api --tool skill
$npx africontext add fedapay-transactions --tool skill
$npx africontext search "orange money"

Sans CLI : GET /api/contexts/<slug>/raw?tool=skill. Pour Claude Code et Cursor en MCP, voir le serveur MCP AfriContext.