Documentation de l’API

Notre API suit le format standard du marché : chaque appel est une requête POST vers une adresse unique, avec votre clé (key) et une action (action). Les scripts revendeurs existants sont donc compatibles sans modification. Créez votre clé depuis votre espace, rubrique « API ».

Adresse : https://sociallikeyou.com/api/v2

Méthode : POST · Réponse : JSON

Liste des services

Paramètre	Description
`key`	Votre clé API
`action`	`services`

Exemple de réponse

[{"service":1,"name":"…","type":"Default","category":"…","rate":"0.9","min":"10","max":"10000","refill":false,"cancel":false}]

Passer une commande

Paramètre	Description
`key`	Votre clé API
`action`	`add`
`service`	ID du service
`link`	Lien
`quantity`	Quantité
`idempotency_key`	Facultatif : identifiant unique pour éviter les doublons en cas de nouvel essai

Exemple de réponse

{"order":23501}

Statut d’une commande

Paramètre	Description
`key`	Votre clé API
`action`	`status`
`order`	ID de la commande

Exemple de réponse

{"charge":"0.27819","start_count":"3572","status":"Partial","remains":"157","currency":"EUR"}

Statut de plusieurs commandes (100 max)

Paramètre	Description
`key`	Votre clé API
`action`	`status`
`orders`	IDs séparés par des virgules

Exemple de réponse

{"1":{"charge":"0.27","start_count":"0","status":"Completed","remains":"0","currency":"EUR"},"10":{"error":"Incorrect order ID"}}

Solde du compte

Paramètre	Description
`key`	Votre clé API
`action`	`balance`

Exemple de réponse

{"balance":"100.84","currency":"EUR"}

API REST (JSON) et notifications

Pour les nouveaux développements, une API REST est disponible à https://sociallikeyou.com/api/rest/v1 avec l’en-tête Authorization: Bearer VOTRE_CLE : GET /services, GET /balance, GET /orders, GET /orders/{id} et POST /orders. La création exige l’en-tête Idempotency-Key, si bien qu’un nouvel essai après une coupure ne crée jamais de doublon. Spécification complète au format OpenAPI : openapi.json.

Notifications : indiquez une adresse HTTPS dans votre espace (rubrique API). À chaque changement de statut, nous envoyons un POST JSON avec l’en-tête X-Webhook-Signature: t=…,v1=…. Pour le vérifier, calculez le HMAC-SHA256 de t.corps avec votre secret. En cas d’échec, l’envoi est retenté jusqu’à 10 fois, sur environ 24 heures.

Erreurs

Les erreurs métier renvoient {"error": "message"}. Clé invalide : HTTP 401. Trop de requêtes : HTTP 429 (limite par défaut : 120 requêtes par minute et par clé).

Exemples

PHP

<?php
$ch = curl_init("https://sociallikeyou.com/api/v2");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        "key" => "VOTRE_CLE", "action" => "add",
        "service" => 1, "link" => "https://exemple.com/page", "quantity" => 1000,
    ]),
]);
$reponse = json_decode(curl_exec($ch), true);

Python

import requests
r = requests.post("https://sociallikeyou.com/api/v2", data={"key": "VOTRE_CLE", "action": "balance"}, timeout=30)
print(r.json())

JavaScript (Node.js)

const r = await fetch("https://sociallikeyou.com/api/v2", {
  method: "POST",
  body: new URLSearchParams({ key: "VOTRE_CLE", action: "services" }),
});
console.log(await r.json());