Partner integration

Dokumentasi API Diablo

Gunakan Bearer API key dari dashboard client untuk membuat request akun iklan, menerima status, dan mendapatkan callback webhook.

Download PDF Integration Guide

Create Facebook Ads Account Order

Endpoint utama untuk website client membuat permintaan akun atau request share akun ke BM partner.

POST /api/v1/orders/facebook-ads-account 
curl -X POST https://api.diabloads.com/api/v1/orders/facebook-ads-account \
  -H "Authorization: Bearer dk_test_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "external_user_id": "user_789",
    "external_order_id": "ORD-CLIENT-001",
    "request_type": "new_account",
    "business_manager_id": "123456789012345",
    "account_name": "Client Ads Account",
    "timezone": "Asia/Jakarta",
    "currency": "IDR",
    "access_level": "full_access",
    "quantity": 1,
    "callback_url": "https://client.com/webhook/diablo",
    "note": "Request akun iklan Facebook untuk dishare ke BM client"
  }'
{
  "external_user_id": "user_789",
  "external_order_id": "ORD-SHARE-001",
  "request_type": "share_existing_account",
  "business_manager_id": "123456789012345",
  "account_name": "Client Existing Ads Account",
  "account_id": "act_1234567890",
  "access_level": "partial_access",
  "callback_url": "https://client.com/webhook/diablo",
  "note": "Minta share akun existing ke BM partner"
}
{
  "ok": true,
  "request": {
    "id": "REQ-ABC123",
    "status": "pending",
    "type": "facebook_ads_account",
    "request_type": "new_account",
    "business_manager_id": "123456789012345",
    "account_name": "Client Ads Account",
    "external_user_id": "user_789",
    "external_order_id": "ORD-CLIENT-001"
  }
}

Webhook Completed

Payload saat request selesai diproses.

{
  "event": "order.completed",
  "request_id": "REQ-ABC123",
  "external_order_id": "ORD-CLIENT-001",
  "external_user_id": "user_789",
  "status": "completed",
  "request": {
    "request_type": "new_account",
    "business_manager_id": "123456789012345",
    "account_name": "Client Ads Account",
    "access_level": "full_access",
    "timezone": "Asia/Jakarta",
    "currency": "IDR"
  },
  "result": {
    "account_name": "Client Ads Account",
    "account_id": "act_1234567890",
    "business_manager_id": "123456789012345",
    "share_status": "shared_to_bm",
    "access_level": "full_access",
    "timezone": "Asia/Jakarta",
    "currency": "IDR",
    "note": "Akun sudah berhasil dishare ke BM client."
  }
}

Webhook Sandbox Test

Payload otomatis untuk membuktikan callback partner siap menerima event.

{
  "event": "sandbox.verified",
  "status": "sandbox_ok",
  "partner": "Partner Diabloads",
  "message": "Diabloads sandbox webhook verification",
  "sent_at": 1780000000
}