Introduction

L'API Social Boost Horizon vous permet de passer des commandes de services de boost de reseaux sociaux directement depuis votre application.

Devise

Tous les prix et montants sont exprimes en XAF (FCFA).

URL de base

Toutes les requetes API doivent etre envoyees a l'URL suivante :

https://socialboosthorizon.com

Authentification

Chaque requete doit inclure votre cle API dans le header HTTP X-Api-Key.

Vous pouvez generer votre cle API depuis votre page de profil.

Exemple de header

X-Api-Key: votre_cle_api_ici

Verifier le solde

GET /api/v1/balance

Recupere le solde actuel de votre compte.

Reponse

200 OK
{
  "success": true,
  "balance": 15000,
  "currency": "XAF"
}
curl -X GET https://socialboosthorizon.com/api/v1/balance \
  -H "X-Api-Key: votre_cle_api"
import requests

url = "https://socialboosthorizon.com/api/v1/balance"
headers = {"X-Api-Key": "votre_cle_api"}

response = requests.get(url, headers=headers)
print(response.json())
$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => "https://socialboosthorizon.com/api/v1/balance",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-Api-Key: votre_cle_api"
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
const response = await fetch("https://socialboosthorizon.com/api/v1/balance", {
    headers: {
        "X-Api-Key": "votre_cle_api"
    }
});

const data = await response.json();
console.log(data);

Lister les services

GET /api/v1/services

Recupere la liste de tous les services disponibles.

Parametres (query)

ParametreTypeDescription
catalog optionnel string Filtrer par catalogue : standard, premium ou gold

Reponse

200 OK
{
  "success": true,
  "services": [
    {
      "service_id": 1,
      "name": "Instagram Followers",
      "category": "Instagram",
      "type": "default",
      "price_per_1000": 5000,
      "min": 100,
      "max": 10000,
      "refill": true,
      "cancel": false,
      "description": "Followers Instagram haute qualite",
      "catalog": "standard"
    }
  ],
  "total": 150,
  "catalogs": ["standard", "premium", "gold"]
}
curl -X GET https://socialboosthorizon.com/api/v1/services \
  -H "X-Api-Key: votre_cle_api"

curl -X GET "https://socialboosthorizon.com/api/v1/services?catalog=standard" \
  -H "X-Api-Key: votre_cle_api"
import requests

url = "https://socialboosthorizon.com/api/v1/services"
headers = {"X-Api-Key": "votre_cle_api"}
params = {"catalog": "standard"}

response = requests.get(url, headers=headers, params=params)
print(response.json())
$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => "https://socialboosthorizon.com/api/v1/services?catalog=standard",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-Api-Key: votre_cle_api"
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
const response = await fetch("https://socialboosthorizon.com/api/v1/services?catalog=standard", {
    headers: {
        "X-Api-Key": "votre_cle_api"
    }
});

const data = await response.json();
console.log(data);

Passer une commande

POST /api/v1/order

Passe une nouvelle commande de service de boost.

Corps de la requete (JSON)

ParametreTypeDescription
service_id requis integer ID du service (obtenu via /api/v1/services)
link requis string Lien du profil ou de la publication cible
quantity requis integer Quantite souhaitee (entre min et max du service)
comments optionnel string Commentaires personnalises (si le service le supporte)
catalog optionnel string Catalogue : standard, premium ou gold (defaut: standard)

Reponse

200 OK
{
  "success": true,
  "order_id": "ORD-1234567890",
  "catalog": "standard",
  "service": "Instagram Followers",
  "quantity": 1000,
  "price": 5000,
  "currency": "XAF",
  "balance": 10000,
  "status": "pending"
}
curl -X POST https://socialboosthorizon.com/api/v1/order \
  -H "X-Api-Key: votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": 1,
    "link": "https://instagram.com/username",
    "quantity": 1000,
    "catalog": "standard"
  }'
import requests

url = "https://socialboosthorizon.com/api/v1/order"
headers = {
    "X-Api-Key": "votre_cle_api",
    "Content-Type": "application/json"
}
data = {
    "service_id": 1,
    "link": "https://instagram.com/username",
    "quantity": 1000,
    "catalog": "standard"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())
$ch = curl_init();

$payload = json_encode([
    "service_id" => 1,
    "link" => "https://instagram.com/username",
    "quantity" => 1000,
    "catalog" => "standard"
]);

curl_setopt_array($ch, [
    CURLOPT_URL => "https://socialboosthorizon.com/api/v1/order",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_HTTPHEADER => [
        "X-Api-Key: votre_cle_api",
        "Content-Type: application/json"
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
const response = await fetch("https://socialboosthorizon.com/api/v1/order", {
    method: "POST",
    headers: {
        "X-Api-Key": "votre_cle_api",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        service_id: 1,
        link: "https://instagram.com/username",
        quantity: 1000,
        catalog: "standard"
    })
});

const data = await response.json();
console.log(data);

Statut d'une commande

GET /api/v1/order/:orderId

Recupere le statut et les details d'une commande specifique.

Parametres (URL)

ParametreTypeDescription
orderId requis string Identifiant de la commande (ex: ORD-1234567890)

Reponse

200 OK
{
  "success": true,
  "order": {
    "order_id": "ORD-1234567890",
    "service": "Instagram Followers",
    "link": "https://instagram.com/username",
    "quantity": 1000,
    "price": 5000,
    "currency": "XAF",
    "status": "completed",
    "catalog": "standard",
    "start_count": 500,
    "remains": 0,
    "created_at": "2025-01-15T10:30:00Z"
  }
}
curl -X GET https://socialboosthorizon.com/api/v1/order/ORD-1234567890 \
  -H "X-Api-Key: votre_cle_api"
import requests

order_id = "ORD-1234567890"
url = f"https://socialboosthorizon.com/api/v1/order/{order_id}"
headers = {"X-Api-Key": "votre_cle_api"}

response = requests.get(url, headers=headers)
print(response.json())
$orderId = "ORD-1234567890";
$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => "https://socialboosthorizon.com/api/v1/order/" . $orderId,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-Api-Key: votre_cle_api"
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
const orderId = "ORD-1234567890";
const response = await fetch(`https://socialboosthorizon.com/api/v1/order/${orderId}`, {
    headers: {
        "X-Api-Key": "votre_cle_api"
    }
});

const data = await response.json();
console.log(data);

Historique des commandes

GET /api/v1/orders

Recupere l'historique de vos commandes.

Parametres (query)

ParametreTypeDescription
limit optionnel integer Nombre de commandes a retourner (defaut: 50, max: 200)

Reponse

200 OK
{
  "success": true,
  "orders": [
    {
      "order_id": "ORD-1234567890",
      "service": "Instagram Followers",
      "quantity": 1000,
      "price": 5000,
      "status": "completed",
      "created_at": "2025-01-15T10:30:00Z"
    }
  ],
  "total": 42
}
curl -X GET "https://socialboosthorizon.com/api/v1/orders?limit=100" \
  -H "X-Api-Key: votre_cle_api"
import requests

url = "https://socialboosthorizon.com/api/v1/orders"
headers = {"X-Api-Key": "votre_cle_api"}
params = {"limit": 100}

response = requests.get(url, headers=headers, params=params)
print(response.json())
$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => "https://socialboosthorizon.com/api/v1/orders?limit=100",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-Api-Key: votre_cle_api"
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
const response = await fetch("https://socialboosthorizon.com/api/v1/orders?limit=100", {
    headers: {
        "X-Api-Key": "votre_cle_api"
    }
});

const data = await response.json();
console.log(data);

Gestion des erreurs

L'API retourne des codes HTTP standards. En cas d'erreur, la reponse contient un objet JSON avec les details :

Exemple d'erreur
{
  "success": false,
  "error": "Cle API manquante ou invalide"
}

Codes d'erreur

CodeDescription
401 Cle API manquante ou invalide
400 Parametres manquants ou invalides, solde insuffisant
404 Commande non trouvee
502 Erreur catalogue (la commande est remboursee automatiquement)
500 Erreur serveur