Endpoints de webhooks
Créer et gérer par l’API les URL qui reçoivent vos événements STRIKE.
Ces endpoints gèrent vos abonnements webhooks par programme ; vous pouvez faire la même chose depuis Développeurs → Webhooks dans le dashboard. Le format des événements, la vérification de signature et la politique de renvoi sont décrits dans le guide Webhooks. Tous ces endpoints exigent le scope webhooks:manage.
/webhook_endpoints
Lister les endpoints
POST
/webhook_endpoints
Créer un endpoint
GET
/webhook_endpoints/:id
Récupérer un endpoint
PATCH
/webhook_endpoints/:id
Modifier un endpoint
DELETE
/webhook_endpoints/:id
Supprimer un endpoint
POST
/webhook_endpoints/:id/rotate_secret
Renouveler le secret
POST
/webhook_endpoints/:id/test
Envoyer un événement de test
GET
/webhook_endpoints/:id/deliveries
Historique des livraisons
POST
/webhook_deliveries/:id/retry
Renvoyer une livraison
L'objet webhook_endpoint
| Champ | Type | Description |
|---|---|---|
id
|
uuid | Identifiant de l’endpoint. |
url
|
string | URL HTTPS publique qui reçoit les événements. |
description
|
string | null | Libellé libre. |
events
|
string[] |
Types d’événements, ou ["*"] pour tous (sauf event.tracked).
|
status
|
string |
active ou disabled.
|
disabled_reason
|
string | null | Raison de la désactivation automatique. |
consecutive_failures
|
integer | Livraisons consécutives en échec (désactivation à 20). |
secret_rotating_until
|
datetime | null | Pendant une rotation : fin de validité de l’ancien secret. |
last_delivery_at
|
datetime | null | Dernière livraison. |
secret
|
string |
Secret de signature whsec_…, retourné uniquement à la création et à la rotation.
|
Lister les endpoints
/api/platform/v1/webhook_endpoints
webhooks:manage
Retourne vos endpoints (sans leur secret).
Paramètres de requête
| Champ | Type | Description |
|---|---|---|
limit
|
integer | Nombre d’éléments par page, de 1 à 100. Par défaut 25. |
cursor
|
string |
Valeur next_cursor de la page précédente. Voir Pagination.
|
Exemple de requête
curl 'https://strikespace.net/api/platform/v1/webhook_endpoints' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints', {
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/webhook_endpoints",
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/webhook_endpoints');
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
{
"object": "list",
"data": [
{
"object": "webhook_endpoint",
"id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
"url": "https://crm.example.com/strike/webhooks",
"description": "Synchronisation CRM",
"events": [
"lead.created",
"lead.updated",
"payment.succeeded"
],
"status": "active",
"disabled_reason": null,
"consecutive_failures": 0,
"secret_rotating_until": null,
"last_delivery_at": "2026-10-16T10:05:52.000Z",
"created_at": "2026-10-16T09:00:00.000Z",
"updated_at": "2026-10-16T09:00:00.000Z"
}
],
"has_more": false,
"next_cursor": null
}
Équivalent pour les agents IA : l'outil MCP list_webhook_endpoints.
Créer un endpoint
/api/platform/v1/webhook_endpoints
webhooks:manage
Enregistre une URL. La réponse contient le secret de signature : conservez-le immédiatement dans votre gestionnaire de secrets, il ne sera plus jamais affiché.
Corps de la requête (JSON)
| Champ | Type | Description |
|---|---|---|
url
requis
|
string |
URL HTTPS publique, sans identifiants. Refusées : localhost, noms .local / .internal ou sans domaine, adresses IP privées.
|
events
requis
|
string[] |
1 à 30 types du catalogue (hors ping), ou ["*"].
|
description
|
string | Libellé libre. |
Exemple de requête
curl -X POST 'https://strikespace.net/api/platform/v1/webhook_endpoints' \
-H "Authorization: Bearer $STRIKE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"url": "https://crm.example.com/strike/webhooks",
"events": [
"lead.created",
"lead.updated",
"payment.succeeded"
],
"description": "Synchronisation CRM"
}'
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"url": "https://crm.example.com/strike/webhooks",
"events": [
"lead.created",
"lead.updated",
"payment.succeeded"
],
"description": "Synchronisation 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/webhook_endpoints",
headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"url": "https://crm.example.com/strike/webhooks",
"events": ["lead.created", "lead.updated", "payment.succeeded"],
"description": "Synchronisation CRM",
},
timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/webhook_endpoints');
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([
'url' => 'https://crm.example.com/strike/webhooks',
'events' => ['lead.created', 'lead.updated', 'payment.succeeded'],
'description' => 'Synchronisation 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');
}
Réponse
{
"object": "webhook_endpoint",
"id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
"url": "https://crm.example.com/strike/webhooks",
"description": "Synchronisation CRM",
"events": [
"lead.created",
"lead.updated",
"payment.succeeded"
],
"status": "active",
"disabled_reason": null,
"consecutive_failures": 0,
"secret_rotating_until": null,
"last_delivery_at": "2026-10-16T10:05:52.000Z",
"created_at": "2026-10-16T09:00:00.000Z",
"updated_at": "2026-10-16T09:00:00.000Z",
"secret": "whsec_8Kd2mP4qR7sT9vW1xY3zA5bC6dE8fG0h"
}
Erreurs spécifiques
invalid_request) ; param indique le champ en cause.
conflict).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Récupérer un endpoint
/api/platform/v1/webhook_endpoints/:id
webhooks:manage
Retourne un endpoint (sans son secret).
Paramètres de chemin
| Champ | Type | Description |
|---|---|---|
id
requis
|
uuid | Identifiant de l’endpoint. |
Exemple de requête
curl 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12', {
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/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
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/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12');
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
{
"object": "webhook_endpoint",
"id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
"url": "https://crm.example.com/strike/webhooks",
"description": "Synchronisation CRM",
"events": [
"lead.created",
"lead.updated",
"payment.succeeded"
],
"status": "active",
"disabled_reason": null,
"consecutive_failures": 0,
"secret_rotating_until": null,
"last_delivery_at": "2026-10-16T10:05:52.000Z",
"created_at": "2026-10-16T09:00:00.000Z",
"updated_at": "2026-10-16T09:00:00.000Z"
}
Erreurs spécifiques
not_found).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Modifier un endpoint
/api/platform/v1/webhook_endpoints/:id
webhooks:manage
Modifie l’URL, les événements, la description, ou désactive / réactive l’endpoint. Un endpoint désactivé automatiquement se réactive avec "status": "active" (le compteur d’échecs repart de zéro).
Paramètres de chemin
| Champ | Type | Description |
|---|---|---|
id
requis
|
uuid | Identifiant de l’endpoint. |
Corps de la requête (JSON)
| Champ | Type | Description |
|---|---|---|
url
|
string | Nouvelle URL HTTPS. |
events
|
string[] | Nouvelle liste d’événements. |
description
|
string | null | Libellé. |
status
|
string |
active ou disabled.
|
Exemple de requête
curl -X PATCH 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12' \
-H "Authorization: Bearer $STRIKE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"events": [
"*"
],
"status": "active"
}'
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12', {
method: 'PATCH',
headers: {
Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"events": [
"*"
],
"status": "active"
}),
})
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.patch(
"https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
json={
"events": ["*"],
"status": "active",
},
timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'PATCH',
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'events' => ['*'],
'status' => 'active',
]),
]);
$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
{
"object": "webhook_endpoint",
"id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
"url": "https://crm.example.com/strike/webhooks",
"description": "Synchronisation CRM",
"events": [
"*"
],
"status": "active",
"disabled_reason": null,
"consecutive_failures": 0,
"secret_rotating_until": null,
"last_delivery_at": "2026-10-16T10:05:52.000Z",
"created_at": "2026-10-16T09:00:00.000Z",
"updated_at": "2026-10-16T09:00:00.000Z"
}
Erreurs spécifiques
not_found).
invalid_request) ; param indique le champ en cause.
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Supprimer un endpoint
/api/platform/v1/webhook_endpoints/:id
webhooks:manage
Supprime l’endpoint et son historique de livraisons. Les livraisons en attente sont abandonnées.
Paramètres de chemin
| Champ | Type | Description |
|---|---|---|
id
requis
|
uuid | Identifiant de l’endpoint. |
Exemple de requête
curl -X DELETE 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12', {
method: 'DELETE',
headers: {
Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
},
})
if (!response.ok) throw new Error((await response.json()).error.message)
import os
import requests
response = requests.delete(
"https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
timeout=10,
)
response.raise_for_status()
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'DELETE',
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
{
"object": "webhook_endpoint",
"id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
"deleted": true
}
Erreurs spécifiques
not_found).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Renouveler le secret
/api/platform/v1/webhook_endpoints/:id/rotate_secret
webhooks:manage
Génère un nouveau secret et le retourne une seule fois. Pendant 24 heures, chaque livraison porte deux signatures v1 (ancien et nouveau secret) : déployez le nouveau secret sans interruption, puis l’ancien cesse d’être utilisé.
Paramètres de chemin
| Champ | Type | Description |
|---|---|---|
id
requis
|
uuid | Identifiant de l’endpoint. |
Exemple de requête
curl -X POST 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/rotate_secret' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/rotate_secret', {
method: 'POST',
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.post(
"https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/rotate_secret",
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/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/rotate_secret');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
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
{
"object": "webhook_endpoint",
"id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
"url": "https://crm.example.com/strike/webhooks",
"description": "Synchronisation CRM",
"events": [
"lead.created",
"lead.updated",
"payment.succeeded"
],
"status": "active",
"disabled_reason": null,
"consecutive_failures": 0,
"secret_rotating_until": "2026-10-17T10:00:00.000Z",
"last_delivery_at": "2026-10-16T10:05:52.000Z",
"created_at": "2026-10-16T09:00:00.000Z",
"updated_at": "2026-10-16T09:00:00.000Z",
"secret": "whsec_Q1w2E3r4T5y6U7i8O9p0A1s2D3f4G5h6"
}
Erreurs spécifiques
not_found).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Envoyer un événement de test
/api/platform/v1/webhook_endpoints/:id/test
webhooks:manage
Envoie immédiatement un événement ping signé à l’URL (une seule tentative) et retourne la livraison avec la réponse de votre serveur.
Paramètres de chemin
| Champ | Type | Description |
|---|---|---|
id
requis
|
uuid | Identifiant de l’endpoint. |
Exemple de requête
curl -X POST 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/test' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/test', {
method: 'POST',
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.post(
"https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/test",
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/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/test');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
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
{
"object": "webhook_delivery",
"id": "aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74",
"endpoint_id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
"event_id": "evt_9xQ2wE4rT6yU8iO0pA1sD3fG",
"event_type": "ping",
"status": "succeeded",
"attempts": 1,
"response_status": 200,
"response_excerpt": "ok",
"error": null,
"next_attempt_at": null,
"delivered_at": "2026-10-16T10:06:00.000Z",
"created_at": "2026-10-16T10:05:51.000Z",
"payload": {
"id": "evt_9xQ2wE4rT6yU8iO0pA1sD3fG",
"object": "event",
"type": "ping",
"data": {
"object": {
"object": "ping",
"message": "Ceci est un test envoyé depuis STRIKE.",
"endpoint_id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12"
}
}
}
}
Erreurs spécifiques
not_found).
conflict).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Historique des livraisons
/api/platform/v1/webhook_endpoints/:id/deliveries
webhooks:manage
Retourne les livraisons des 30 derniers jours, de la plus récente à la plus ancienne, avec le code HTTP, un extrait de votre réponse (1 000 caractères max.) et le contenu envoyé (payload).
Paramètres de chemin
| Champ | Type | Description |
|---|---|---|
id
requis
|
uuid | Identifiant de l’endpoint. |
Paramètres de requête
| Champ | Type | Description |
|---|---|---|
status
|
string |
pending, succeeded ou failed.
|
limit
|
integer | Nombre d’éléments par page, de 1 à 100. Par défaut 25. |
cursor
|
string |
Valeur next_cursor de la page précédente. Voir Pagination.
|
Exemple de requête
curl 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/deliveries?status=failed' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/deliveries?status=failed', {
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/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/deliveries",
headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
params={
"status": "failed",
},
timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/deliveries?status=failed');
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
{
"object": "list",
"data": [
{
"object": "webhook_delivery",
"id": "aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74",
"endpoint_id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
"event_id": "evt_4Fz9kQ2LmN8pR1sT6vW3xY5z",
"event_type": "lead.created",
"status": "pending",
"attempts": 3,
"response_status": 503,
"response_excerpt": "Service Unavailable",
"error": null,
"next_attempt_at": "2026-10-16T10:42:00.000Z",
"delivered_at": null,
"created_at": "2026-10-16T10:05:51.000Z",
"payload": {
"id": "evt_4Fz9kQ2LmN8pR1sT6vW3xY5z",
"object": "event",
"type": "lead.created",
"data": {
"object": {
"object": "lead",
"id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80"
}
}
}
}
],
"has_more": false,
"next_cursor": null
}
Erreurs spécifiques
not_found).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Renvoyer une livraison
/api/platform/v1/webhook_deliveries/:id/retry
webhooks:manage
Crée une nouvelle livraison du même événement (même Strike-Event-Id, nouveau Strike-Delivery-Id) et l’envoie immédiatement. Votre code doit donc dédoublonner sur l’identifiant d’événement.
Paramètres de chemin
| Champ | Type | Description |
|---|---|---|
id
requis
|
uuid | Identifiant de la livraison. |
Exemple de requête
curl -X POST 'https://strikespace.net/api/platform/v1/webhook_deliveries/aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74/retry' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/webhook_deliveries/aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74/retry', {
method: 'POST',
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.post(
"https://strikespace.net/api/platform/v1/webhook_deliveries/aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74/retry",
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/webhook_deliveries/aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74/retry');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
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
{
"object": "webhook_delivery",
"id": "bb43c4d5-e6f7-4a8b-9c0d-1e2f3a4b5c6d",
"endpoint_id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12",
"event_id": "evt_4Fz9kQ2LmN8pR1sT6vW3xY5z",
"event_type": "lead.created",
"status": "pending",
"attempts": 0,
"response_status": null,
"response_excerpt": null,
"error": null,
"next_attempt_at": "2026-10-16T10:30:00.000Z",
"delivered_at": null,
"created_at": "2026-10-16T10:05:51.000Z",
"payload": {
"id": "evt_4Fz9kQ2LmN8pR1sT6vW3xY5z",
"object": "event",
"type": "lead.created",
"data": {
"object": {
"object": "lead",
"id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80"
}
}
}
}
Erreurs spécifiques
not_found).
conflict).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Une question sur l'intégration ? Écrivez à
contact@strike.app
en indiquant l'endpoint, l'heure et le request_id de la réponse.