Démarrage

L’API publique ASAP est une API REST versionnée, servie sur :

https://api.asap.cool/v1

Elle permet d’intégrer ASAP à vos scripts, Zapier, n8n, Make, ou toute application tierce.

1. Créer une clé API

Depuis app.asap.cool, allez dans Paramètres → Clés API et créez une clé. Elle se présente sous la forme asap_pk_live_<32 caractères> et n’est affichée qu’une seule fois — copiez-la immédiatement.

Chaque clé porte des scopes qui déterminent les ressources accessibles (ex. contacts:read, invoice:write).

2. Premier appel

Authentifiez-vous avec un header Authorization: Bearer <clé> :

curl https://api.asap.cool/v1/contacts \
  -H "Authorization: Bearer asap_pk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

3. Lire la réponse

Toutes les réponses sont enveloppées dans un objet { data, meta } :

{
  "data": [{ "id": "...", "name": "Acme SAS", "email": "[email protected]" }],
  "meta": {
    "request_id": "req_abc123",
    "next_cursor": "eyJpZCI6IjE3MyJ9",
    "has_more": true
  }
}

Le champ request_id identifie l’appel — fournissez-le au support en cas de problème. La pagination se fait par curseur ; voir Conventions.

Étapes suivantes

• Authentification — clés, scopes, sécurité.
• Rate limiting — quotas par plan.
• Idempotency — rejouer un POST sans doublon.
• Référence API — la liste complète des endpoints.