استكشاف الفواتير

curl https://billapi.oneclickdz.com/v3/bills/discover \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Access-Token: YOUR_API_KEY" \
  -d '{
    "partner": "ADE",
    "account": { "reference": "0123456789012345678901234" },
    "ref": "disc-inv-2026-0042"
  }'

const BASE = "https://billapi.oneclickdz.com";
const KEY = process.env.ONECLICKDZ_API_KEY;

async function startDiscovery(partner, account, ref) {
  const response = await fetch(`${BASE}/v3/bills/discover`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-Access-Token": KEY,
    },
    body: JSON.stringify({ partner, account, ref }),
  });

  const body = await response.json();

  if (!body.success) {
    throw new Error(`${body.error.code}: ${body.error.message}`);
  }

  // PENDING — the bills are not here yet.
  return body.data.transactionId;
}

const transactionId = await startDiscovery(
  "ADE",
  { reference: "0123456789012345678901234" },
  "disc-inv-2026-0042",
);

import os
import requests

BASE = 'https://billapi.oneclickdz.com'
KEY = os.getenv('ONECLICKDZ_API_KEY')


def start_discovery(partner, account, ref):
    response = requests.post(
        f'{BASE}/v3/bills/discover',
        headers={
            'Content-Type': 'application/json',
            'X-Access-Token': KEY
        },
        json={'partner': partner, 'account': account, 'ref': ref}
    )

    body = response.json()

    if not body['success']:
        raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")

    # PENDING — the bills are not here yet.
    return body['data']['transactionId']


transaction_id = start_discovery(
    'ADE',
    {'reference': '0123456789012345678901234'},
    'disc-inv-2026-0042'
)

<?php
const BASE = 'https://billapi.oneclickdz.com';

function startDiscovery(string $partner, array $account, string $ref): string
{
    $ch = curl_init(BASE . '/v3/bills/discover');
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Content-Type: application/json',
        'X-Access-Token: ' . getenv('ONECLICKDZ_API_KEY')
    ]);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
        'partner' => $partner,
        'account' => $account,
        'ref'     => $ref
    ]));

    $body = json_decode(curl_exec($ch), true);
    curl_close($ch);

    if (!$body['success']) {
        throw new Exception($body['error']['code'] . ': ' . $body['error']['message']);
    }

    // PENDING — the bills are not here yet.
    return $body['data']['transactionId'];
}

$transactionId = startDiscovery(
    'ADE',
    ['reference' => '0123456789012345678901234'],
    'disc-inv-2026-0042'
);
?>

curl https://billapi.oneclickdz.com/v3/bills/transactions/68b2f4c1a7d3e9f204c81a55 \
  -H "X-Access-Token: YOUR_API_KEY"

const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function waitForBills(transactionId, { timeoutMs = 90_000 } = {}) {
  const deadline = Date.now() + timeoutMs;
  let interval = 2000;

  while (Date.now() < deadline) {
    const response = await fetch(
      `${BASE}/v3/bills/transactions/${transactionId}`,
      { headers: { "X-Access-Token": KEY } },
    );

    const body = await response.json();
    if (!body.success) throw new Error(body.error.code);

    const transaction = body.data;

    if (transaction.status === "READY") return transaction.bills;
    if (transaction.status === "FAILED") {
      throw new Error(transaction.error?.code ?? "FAILED");
    }

    await sleep(interval);
    interval = Math.min(interval * 1.5, 10_000);
  }

  throw new Error("Discovery did not finish in time");
}

const bills = await waitForBills(transactionId);

import time


def wait_for_bills(transaction_id, timeout_s=90):
    deadline = time.monotonic() + timeout_s
    interval = 2.0

    while time.monotonic() < deadline:
        response = requests.get(
            f'{BASE}/v3/bills/transactions/{transaction_id}',
            headers={'X-Access-Token': KEY}
        )

        body = response.json()
        if not body['success']:
            raise RuntimeError(body['error']['code'])

        transaction = body['data']

        if transaction['status'] == 'READY':
            return transaction.get('bills', [])
        if transaction['status'] == 'FAILED':
            raise RuntimeError(transaction.get('error', {}).get('code', 'FAILED'))

        time.sleep(interval)
        interval = min(interval * 1.5, 10.0)

    raise TimeoutError('Discovery did not finish in time')


bills = wait_for_bills(transaction_id)

<?php
function waitForBills(string $transactionId, int $timeoutSeconds = 90): array
{
    $deadline = time() + $timeoutSeconds;
    $interval = 2;

    while (time() < $deadline) {
        $ch = curl_init(BASE . "/v3/bills/transactions/$transactionId");
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'X-Access-Token: ' . getenv('ONECLICKDZ_API_KEY')
        ]);

        $body = json_decode(curl_exec($ch), true);
        curl_close($ch);

        if (!$body['success']) {
            throw new Exception($body['error']['code']);
        }

        $transaction = $body['data'];

        if ($transaction['status'] === 'READY') {
            return $transaction['bills'] ?? [];
        }
        if ($transaction['status'] === 'FAILED') {
            throw new Exception($transaction['error']['code'] ?? 'FAILED');
        }

        sleep($interval);
        $interval = min((int) ceil($interval * 1.5), 10);
    }

    throw new Exception('Discovery did not finish in time');
}

$bills = waitForBills($transactionId);
?>