قائمة الشركاء
curl --request GET \
--url https://api.oneclickdz.com/v3/bills/partners \
--header 'X-Access-Token: <api-key>'import requests
url = "https://api.oneclickdz.com/v3/bills/partners"
headers = {"X-Access-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Access-Token': '<api-key>'}};
fetch('https://api.oneclickdz.com/v3/bills/partners', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.oneclickdz.com/v3/bills/partners",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Access-Token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.oneclickdz.com/v3/bills/partners"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Access-Token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.oneclickdz.com/v3/bills/partners")
.header("X-Access-Token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.oneclickdz.com/v3/bills/partners")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Access-Token"] = '<api-key>'
response = http.request(request)
puts response.read_bodyدفع الفواتير
قائمة الشركاء
إتاحة كل مُصدِر فاتورة مدعوم
GET
/
v3
/
bills
/
partners
قائمة الشركاء
curl --request GET \
--url https://api.oneclickdz.com/v3/bills/partners \
--header 'X-Access-Token: <api-key>'import requests
url = "https://api.oneclickdz.com/v3/bills/partners"
headers = {"X-Access-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Access-Token': '<api-key>'}};
fetch('https://api.oneclickdz.com/v3/bills/partners', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.oneclickdz.com/v3/bills/partners",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Access-Token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.oneclickdz.com/v3/bills/partners"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Access-Token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.oneclickdz.com/v3/bills/partners")
.header("X-Access-Token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.oneclickdz.com/v3/bills/partners")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Access-Token"] = '<api-key>'
response = http.request(request)
puts response.read_bodyتُعيد مُدخلًا واحدًا لكل مُصدِر فاتورة مع حالة إتاحته الحالية. المفاتيح هي قيم
partner الدقيقة التي تقبلها اكتشاف الفواتير.يرى مفتاح الإنتاج الإتاحة الفعلية. أما مفتاح Sandbox فيرى جميع مُصدِري الفواتير بالحالة ACTIVE.الاستجابة
object
مطلوب
خريطة مفاتيحها أسماء الشركاء:
ADE وAADL وSONELGAZ وSEAAL وSEOR وAlgérie Télécom.إظهار المُدخل
إظهار المُدخل
string
مطلوب
ACTIVE أو UNAVAILABLE. يُجيب مُصدِر الفاتورة غير المتاح بالخطأ 503 PARTNER_UNAVAILABLE على الاكتشاف والدفع.مثال
curl https://api.oneclickdz.com/v3/bills/partners \
-H "X-Access-Token: YOUR_API_KEY"
const response = await fetch("https://api.oneclickdz.com/v3/bills/partners", {
headers: { "X-Access-Token": process.env.ONECLICKDZ_API_KEY },
});
const body = await response.json();
if (!body.success) throw new Error(body.error.code);
const available = Object.keys(body.data).filter((p) => body.data[p].status === "ACTIVE");
import os, requests
response = requests.get(
"https://api.oneclickdz.com/v3/bills/partners",
headers={"X-Access-Token": os.environ["ONECLICKDZ_API_KEY"]},
)
body = response.json()
if not body["success"]:
raise RuntimeError(body["error"]["code"])
available = [p for p, v in body["data"].items() if v["status"] == "ACTIVE"]
<?php
$ch = curl_init("https://api.oneclickdz.com/v3/bills/partners");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
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"]);
}
$available = array_keys(array_filter($body["data"], fn($v) => $v["status"] === "ACTIVE"));
?>
Response
{
"success": true,
"data": {
"ADE": { "status": "ACTIVE" },
"AADL": { "status": "ACTIVE" },
"SONELGAZ": { "status": "ACTIVE" },
"SEAAL": { "status": "ACTIVE" },
"SEOR": { "status": "ACTIVE" },
"Algérie Télécom": { "status": "UNAVAILABLE" }
},
"meta": { "timestamp": "2026-09-20T10:15:32.194Z" },
"requestId": "req_9f3a1c72e0b84d51aB3xZq07"
}
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
| 401 | MISSING_ACCESS_TOKEN | لا توجد ترويسة X-Access-Token |
| 401 | INVALID_ACCESS_TOKEN | رُفض المفتاح |
| 503 | AUTH_UNAVAILABLE | تعذّر التحقّق من المفتاح في الوقت المحدّد؛ أعد المحاولة بعد Retry-After |

