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 您的密钥 : 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"}。密钥无效：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());