Démarrage rapide

Créez une clé API et faites vos premiers appels en cinq minutes.

En cinq minutes, vous créez une clé API, vérifiez l'accès à votre compte, puis créez et listez vos premiers leads.

L'API REST, les webhooks et les agents IA sont inclus dans les offres Pro et Enterprise. Seuls le propriétaire du compte et les administrateurs de l'équipe peuvent créer une clé.

1. Créez une clé API

  1. Ouvrez votre dashboard, section Développeurs → Clés API.
  2. Cliquez sur Créer une clé et donnez-lui un nom explicite (par exemple « Back-office production »).
  3. Cochez uniquement les scopes nécessaires. Pour ce guide : leads:read et leads:write.
  4. Facultatif : une date d'expiration et une liste d'adresses IP autorisées.
  5. Copiez la clé sk_live_… : elle n'est affichée qu'une seule fois.

Rangez-la dans une variable d'environnement ou dans votre gestionnaire de secrets :

Terminal
# Stockez la clé dans une variable d'environnement, jamais dans le code
export STRIKE_API_KEY="sk_live_votre_cle"

Une clé sk_live_ donne accès aux données de votre compte. Ne la placez jamais dans le code d'un site web, d'une application mobile ou d'un dépôt Git. Pour le navigateur, utilisez la clé de tracking publique.

2. Vérifiez l'accès avec GET /me

Toutes les requêtes s'authentifient avec l'en-tête Authorization: Bearer <clé>. L'endpoint /me retourne votre compte, votre offre, les scopes de la clé et vos limites :

curl 'https://strikespace.net/api/platform/v1/me' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/me', {
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
  },
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import requests

response = requests.get(
    "https://strikespace.net/api/platform/v1/me",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/me');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
    ],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}
Réponse 200
{
  "object": "workspace",
  "id": "b6d767d2-f8ed-4c21-9a6f-3e4d5c6b7a85",
  "name": "Maison Adjara",
  "plan": "pro",
  "scopes": [
    "leads:read",
    "leads:write",
    "events:write"
  ],
  "principal": {
    "kind": "api_key",
    "id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
    "label": "Back-office",
    "role": "admin"
  },
  "limits": {
    "requests_per_minute": 60,
    "requests_per_day": 50000,
    "api_keys": 10,
    "webhook_endpoints": 5,
    "connected_agents": 20
  }
}

Une réponse 401 signifie que la clé est absente, mal copiée, expirée ou révoquée ; une réponse 403 avec plan_required que votre compte n'est pas en offre Pro ou Enterprise.

3. Créez votre premier lead

POST /leads crée le lead, ou met à jour celui qui a déjà cet email ou ce numéro. L'en-tête Idempotency-Key vous permet de rejouer la requête sans risque de doublon.

curl -X POST 'https://strikespace.net/api/platform/v1/leads' \
  -H "Authorization: Bearer $STRIKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "first_name": "Awa",
    "email": "awa@exemple.com",
    "phone_number": "+22997000000",
    "traits": {
      "source": "crm"
    }
  }'
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/leads', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    "first_name": "Awa",
    "email": "awa@exemple.com",
    "phone_number": "+22997000000",
    "traits": {
      "source": "crm"
    }
  }),
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import uuid
import requests

response = requests.post(
    "https://strikespace.net/api/platform/v1/leads",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    json={
        "first_name": "Awa",
        "email": "awa@exemple.com",
        "phone_number": "+22997000000",
        "traits": {
            "source": "crm",
        },
    },
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/leads');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: ' . bin2hex(random_bytes(16)),
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'first_name' => 'Awa',
        'email' => 'awa@exemple.com',
        'phone_number' => '+22997000000',
        'traits' => [
            'source' => 'crm',
        ],
    ]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

La réponse 201 contient le lead avec "created": true ; s'il existait déjà, vous recevez 200 et "created": false. Le lead apparaît immédiatement dans votre dashboard et reçoit son message de bienvenue.

4. Listez vos leads

curl 'https://strikespace.net/api/platform/v1/leads?status=warm&limit=10' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/leads?status=warm&limit=10', {
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
  },
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import requests

response = requests.get(
    "https://strikespace.net/api/platform/v1/leads",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    params={
        "status": "warm",
        "limit": 10,
    },
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/leads?status=warm&limit=10');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
    ],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

Les listes sont paginées par curseur : tant que has_more vaut true, rappelez l'endpoint avec cursor=<next_cursor>. Voir Pagination.

Et ensuite ?

Une question sur l'intégration ? Écrivez à contact@strike.app en indiquant l'endpoint, l'heure et le request_id de la réponse.