API का दस्तावेज़ीकरण

हमारा API बाज़ार के मानक प्रारूप का पालन करता है: हर कॉल एक POST अनुरोध है, एक ही पते पर, आपकी key (key) और एक action (action)। इसलिए मौजूदा रीसेलर स्क्रिप्ट बिना किसी बदलाव के काम करती हैं। अपनी key अपने खाते के “API” अनुभाग से बनाएँ।

पता: https://sociallikeyou.com/api/v2

विधि: POST · उत्तर: JSON

Liste des services

पैरामीटर	विवरण
`key`	आपकी API key
`action`	`services`

प्रतिक्रिया का उदाहरण

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

Passer une commande

पैरामीटर	विवरण
`key`	आपकी API key
`action`	`add`
`service`	ID du service
`link`	Lien
`quantity`	Quantité
`idempotency_key`	Facultatif : identifiant unique pour éviter les doublons en cas de nouvel essai

प्रतिक्रिया का उदाहरण

{"order":23501}

Statut d’une commande

पैरामीटर	विवरण
`key`	आपकी API key
`action`	`status`
`order`	ID de la commande

प्रतिक्रिया का उदाहरण

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

Statut de plusieurs commandes (100 max)

पैरामीटर	विवरण
`key`	आपकी API key
`action`	`status`
`orders`	IDs séparés par des virgules

प्रतिक्रिया का उदाहरण

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

Solde du compte

पैरामीटर	विवरण
`key`	आपकी API key
`action`	`balance`

प्रतिक्रिया का उदाहरण

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

REST API (JSON) और सूचनाएँ

नए विकास के लिए, REST API यहाँ उपलब्ध है: https://sociallikeyou.com/api/rest/v1 इस हेडर के साथ: Authorization: Bearer VOTRE_CLE : GET /services, GET /balance, GET /orders, GET /orders/{id} और POST /orders। बनाने के लिए यह हेडर आवश्यक है: Idempotency-Key, ताकि कनेक्शन टूटने के बाद दोबारा प्रयास करने पर कभी डुप्लिकेट न बने। OpenAPI प्रारूप में पूरा विनिर्देश: openapi.json.

सूचनाएँ: अपने खाते (API अनुभाग) में एक HTTPS पता दर्ज करें। हर स्थिति परिवर्तन पर हम एक POST JSON भेजते हैं, इस हेडर के साथ: X-Webhook-Signature: t=…,v1=…। इसे सत्यापित करने के लिए, HMAC-SHA256 की गणना करें: t.corps अपने सीक्रेट से। विफल होने पर, भेजने का प्रयास लगभग 24 घंटों में अधिकतम 10 बार दोहराया जाता है।

त्रुटियाँ

व्यावसायिक त्रुटियाँ यह लौटाती हैं: {"error": "message"}। अमान्य key: HTTP 401। बहुत अधिक अनुरोध: HTTP 429 (डिफ़ॉल्ट सीमा: प्रति key प्रति मिनट 120 अनुरोध)।

उदाहरण

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());