Tunnels

Lire vos tunnels de vente et leurs statistiques.

Les tunnels sont vos pages de capture hébergées par STRIKE. L’API donne accès à leur configuration et à leurs performances pour vos tableaux de bord internes.

L'objet funnel

Champ Type Description
id uuid Identifiant du tunnel.
name string Nom interne.
slug string Segment d’URL de la page publique.
status string draft, published ou paused.
template string Modèle de page : minimal, showcase ou urgency.
url string URL publique de la page.
product_name string | null Produit vendu.
product_price integer | null Prix, dans la devise currency (FCFA).
campaign_id uuid | null Flux de relance associé.
stats object Uniquement sur GET /funnels/:id : leads, converted_leads, conversion_rate (0 à 1), payments_succeeded, revenue, currency.

Lister les tunnels

GET /api/platform/v1/funnels funnels:read

Retourne les tunnels du compte.

Paramètres de requête

Champ Type Description
status string draft, published ou paused.
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/funnels?status=published' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/funnels?status=published', {
  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/funnels",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    params={
        "status": "published",
    },
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/funnels?status=published');
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

Réponse 200
{
  "object": "list",
  "data": [
    {
      "object": "funnel",
      "id": "3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21",
      "name": "Collection d’été",
      "slug": "collection-ete",
      "status": "published",
      "template": "showcase",
      "url": "https://strikespace.net/f/collection-ete",
      "headline": "La collection d’été est arrivée",
      "product_name": "Robe wax",
      "product_price": 15000,
      "currency": "XOF",
      "campaign_id": "e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54",
      "created_at": "2026-08-20T12:00:00.000Z",
      "updated_at": "2026-10-10T09:00:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Équivalent pour les agents IA : l'outil MCP list_funnels.

Récupérer un tunnel et ses statistiques

GET /api/platform/v1/funnels/:id funnels:read

Retourne le tunnel avec ses statistiques cumulées.

Paramètres de chemin

Champ Type Description
id requis uuid Identifiant du tunnel.

Exemple de requête

curl 'https://strikespace.net/api/platform/v1/funnels/3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/funnels/3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21', {
  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/funnels/3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21",
    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/funnels/3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21');
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

Réponse 200
{
  "object": "funnel",
  "id": "3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21",
  "name": "Collection d’été",
  "slug": "collection-ete",
  "status": "published",
  "template": "showcase",
  "url": "https://strikespace.net/f/collection-ete",
  "headline": "La collection d’été est arrivée",
  "product_name": "Robe wax",
  "product_price": 15000,
  "currency": "XOF",
  "campaign_id": "e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54",
  "created_at": "2026-08-20T12:00:00.000Z",
  "updated_at": "2026-10-10T09:00:00.000Z",
  "stats": {
    "leads": 412,
    "converted_leads": 37,
    "conversion_rate": 0.0898,
    "payments_succeeded": 37,
    "revenue": 555000,
    "currency": "XOF"
  }
}

Erreurs spécifiques

404 Tunnel introuvable, ou appartenant à un autre compte (not_found).

Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans Conventions.

Équivalent pour les agents IA : l'outil MCP get_funnel.

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