Aller au contenu principal

Démarrage rapide

1. Obtenir une clé API​

Allaw vous fournit une clé au format :

sk_live_…

Stockez-la côté serveur uniquement. Ne l’embarquez jamais dans une app mobile ou un front public.

2. Appeler /v1/me​

curl -sS https://naas.allaw.fr/v1/me \
  -H "Authorization: Bearer sk_live_…"

Réponse attendue (extrait) :

{
  "key_prefix": "sk_live_XXXX",
  "name": "Mon intégration CRM",
  "default_organization_id": "org_…"
}

3. Créer une notoriété​

Le header Idempotency-Key est obligatoire sur les POST métier.

curl -sS https://naas.allaw.fr/v1/notorieties \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: notoriety-$(uuidgen)" \
  -d '{
    "data": {
      "requester": {
        "fullName": "Marie Dupont",
        "capacity": "heir",
        "email": "[email protected]"
      }
    }
  }'
  • 201 : ressource créée
  • 200 : rejeu idempotent (même clé + même intention)

4. Explorer l’OpenAPI​

La référence interactive (Swagger UI) est disponible sur naas.allaw.fr/docs.

astuce

Dans Swagger, cliquez Authorize et collez la valeur complète : Bearer sk_live_… (mot Bearer + espace + clé).