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
- Ouvrez votre dashboard, section Développeurs → Clés API.
- Cliquez sur Créer une clé et donnez-lui un nom explicite (par exemple « Back-office production »).
- Cochez uniquement les scopes nécessaires. Pour ce guide :
leads:readetleads:write. - Facultatif : une date d'expiration et une liste d'adresses IP autorisées.
- 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 :
# 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');
}
{
"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 ?
- Recevoir les événements : créez un webhook sur
lead.createdoupayment.succeeded. - Envoyer l'activité de vos clients : POST /events depuis votre serveur.
- Connecter un assistant IA : suivez le guide Agents IA & MCP.
- Passer en production : relisez les bonnes pratiques de sécurité et la gestion des limites de débit.
Une question sur l'intégration ? Écrivez à
contact@strike.app
en indiquant l'endpoint, l'heure et le request_id de la réponse.