توثيق واجهة API

تتبع واجهة API الخاصة بنا الصيغة القياسية في السوق: كل استدعاء هو طلب POST إلى عنوان واحد، مع مفتاحك (key) وإجراء (action). لذلك تعمل سكربتات الموزّعين الحالية دون أي تعديل. أنشئ مفتاحك من حسابك، قسم «API».

العنوان: https://sociallikeyou.com/api/v2

الطريقة: POST · الرد: JSON

Liste des services

المعامل	الوصف
`key`	مفتاح API الخاص بك
`action`	`services`

مثال على الاستجابة

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

Passer une commande

المعامل	الوصف
`key`	مفتاح 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

مثال على الاستجابة

{"order":23501}

Statut d’une commande

المعامل	الوصف
`key`	مفتاح API الخاص بك
`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 الخاص بك
`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 الخاص بك
`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.

الإشعارات: أدخل عنوان HTTPS في مساحتك (قسم API). مع كل تغيير في الحالة، نرسل طلب POST JSON مع الترويسة X-Webhook-Signature: t=…,v1=…. للتحقق منه، احسب HMAC-SHA256 لـ t.corps باستخدام سرّك. في حال الفشل، تُعاد محاولة الإرسال حتى 10 مرات على مدى 24 ساعة تقريبًا.

الأخطاء

تُرجع أخطاء العمل {"error": "message"}. مفتاح غير صالح: HTTP 401. طلبات كثيرة جدًا: HTTP 429 (الحد الافتراضي: 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());