API документація BlackPost

Authorization: Bearer bg_ваш_api_ключ

https://blackpost.com.ua/api/v1/check?phone=380971234567&api_key=bg_ваш_api_ключ

curl -H "Authorization: Bearer bg_abc123..." \
  https://blackpost.com.ua/api/v1/health

curl -H "Authorization: Bearer bg_abc123..." \
  "https://blackpost.com.ua/api/v1/check?phone=380971234567"

curl -H "Authorization: Bearer bg_abc123..." \
  "https://blackpost.com.ua/api/v1/check?name=Петренко"

curl -X POST \
  -H "Authorization: Bearer bg_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "buyers": [
      {"phone": "380971234567"},
      {"phone": "380501112233", "name": "Іваненко"},
      {"phone": "380631234567"}
    ]
  }' \
  https://blackpost.com.ua/api/v1/check/bulk

curl -X POST \
  -H "Authorization: Bearer bg_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "buyer_phone": "380971234567",
    "buyer_last_name": "Петренко",
    "buyer_first_name": "Іван",
    "ttn_number": "20450000123456",
    "delivery_service": "nova_poshta",
    "category": "non_pickup",
    "order_amount": 1500.00,
    "comment": "Покупець не забрав посилку протягом 5 днів"
  }' \
  https://blackpost.com.ua/api/v1/report

curl -H "Authorization: Bearer bg_abc123..." \
  https://blackpost.com.ua/api/v1/buyer/380971234567

curl https://blackpost.com.ua/api/v1/stats

import requests

API_KEY = "bg_ваш_api_ключ"
BASE_URL = "https://blackpost.com.ua/api/v1"

headers = {"Authorization": f"Bearer {API_KEY}"}

# Перевірка покупця
resp = requests.get(
    f"{BASE_URL}/check",
    params={"phone": "380971234567"},
    headers=headers
)
data = resp.json()

if data["found"]:
    score = data["buyer"]["risk_score"]
    print(f"Ризик: {score}/100 — {data['recommendation']}")
else:
    print("Покупець чистий")

const API_KEY = "bg_ваш_api_ключ";
const BASE_URL = "https://blackpost.com.ua/api/v1";

async function checkBuyer(phone) {
  const resp = await fetch(
    `${BASE_URL}/check?phone=${phone}`,
    { headers: { "Authorization": `Bearer ${API_KEY}` } }
  );
  const data = await resp.json();

  if (data.found) {
    console.log(`Ризик: ${data.buyer.risk_score}/100`);
    console.log(`Рекомендація: ${data.recommendation}`);
  } else {
    console.log("Покупець чистий");
  }
}

checkBuyer("380971234567");

$apiKey = "bg_ваш_api_ключ";
$phone = "380971234567";

$ch = curl_init("https://blackpost.com.ua/api/v1/check?phone={$phone}");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer {$apiKey}"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

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

$data = json_decode($response, true);

if ($data['found']) {
    $score = $data['buyer']['risk_score'];
    echo "Ризик: {$score}/100 — {$data['recommendation']}";
} else {
    echo "Покупець чистий";
}