الحصول على رصيد الحساب
curl --request GET \
--url https://api.oneclickdz.com/v3/account/balance \
--header 'X-Access-Token: <api-key>'import requests
url = "https://api.oneclickdz.com/v3/account/balance"
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/account/balance', 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/account/balance",
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/account/balance"
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/account/balance")
.header("X-Access-Token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.oneclickdz.com/v3/account/balance")
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
/
account
/
balance
الحصول على رصيد الحساب
curl --request GET \
--url https://api.oneclickdz.com/v3/account/balance \
--header 'X-Access-Token: <api-key>'import requests
url = "https://api.oneclickdz.com/v3/account/balance"
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/account/balance', 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/account/balance",
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/account/balance"
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/account/balance")
.header("X-Access-Token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.oneclickdz.com/v3/account/balance")
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نظرة عامة
احصل على رصيد حسابك الحالي بالدينار الجزائري (DZD). يمثّل الرصيد الأموال المتاحة التي يمكن استخدامها للشحن والطلبات والخدمات الأخرى.عندما يصل رصيدك إلى حد منخفض، سيُرسَل إشعار إلى عنوان بريدك الإلكتروني
المسجّل.
الاستجابة
boolean
مطلوب
true للطلبات الناجحةمثال على الطلب
curl --request GET \
--url https://api.oneclickdz.com/v3/account/balance \
--header 'X-Access-Token: YOUR_API_KEY'
const response = await fetch("https://api.oneclickdz.com/v3/account/balance", {
headers: {
"X-Access-Token": process.env.ONECLICKDZ_API_KEY,
},
});
const data = await response.json();
if (data.success) {
console.log(`Balance: ${data.data.balance} DZD`);
}
import requests
import os
response = requests.get(
'https://api.oneclickdz.com/v3/account/balance',
headers={'X-Access-Token': os.getenv('ONECLICKDZ_API_KEY')}
)
data = response.json()
if data['success']:
print(f"Balance: {data['data']['balance']} DZD")
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.oneclickdz.com/v3/account/balance');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-Access-Token: ' . getenv('ONECLICKDZ_API_KEY')
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
if ($data['success']) {
echo "Balance: " . $data['data']['balance'] . " DZD\n";
}
?>
مثال على الاستجابة
{
"success": true,
"data": {
"balance": 1326.13
},
"meta": {
"timestamp": "2025-10-29T00:35:58.710Z"
}
}
حالات الاستخدام
الفحص قبل المعاملة
تحقق من الأموال الكافية قبل معالجة الطلبات
عرض الرصيد
اعرض الرصيد الحالي في واجهة المستخدم لتطبيقك
تنبيهات الرصيد المنخفض
راقب الرصيد وأرسل تنبيهًا عند انخفاضه
التقارير المالية
تتبع تغييرات الرصيد بمرور الوقت
أمثلة على التكامل
التحقق قبل المعاملة
async function canProcessTransaction(amount) {
const response = await fetch(
"https://api.oneclickdz.com/v3/account/balance",
{
headers: { "X-Access-Token": API_KEY },
}
);
const data = await response.json();
if (!data.success) {
throw new Error("Failed to check balance");
}
const balance = data.data.balance;
if (balance < amount) {
throw new Error(
`Insufficient balance. Required: ${amount} DZD, Available: ${balance} DZD`
);
}
return true;
}
// Usage
try {
await canProcessTransaction(500);
// Proceed with transaction
} catch (error) {
console.error(error.message);
}
مراقبة الرصيد
class BalanceMonitor {
constructor(apiKey, lowBalanceThreshold = 1000) {
this.apiKey = apiKey;
this.lowBalanceThreshold = lowBalanceThreshold;
this.lastBalance = null;
}
async checkBalance() {
const response = await fetch(
"https://api.oneclickdz.com/v3/account/balance",
{
headers: { "X-Access-Token": this.apiKey },
}
);
const data = await response.json();
if (!data.success) {
console.error("Failed to check balance:", data.error);
return;
}
const currentBalance = data.data.balance;
if (currentBalance < this.lowBalanceThreshold) {
this.onLowBalance(currentBalance);
}
if (this.lastBalance !== null) {
const change = currentBalance - this.lastBalance;
if (Math.abs(change) > 100) {
this.onBalanceChange(change, currentBalance);
}
}
this.lastBalance = currentBalance;
return currentBalance;
}
startMonitoring(intervalMinutes = 5) {
this.checkBalance();
setInterval(() => {
this.checkBalance();
}, intervalMinutes * 60 * 1000);
}
}
// Usage
const monitor = new BalanceMonitor(API_KEY, 1000);
monitor.startMonitoring(5);
أفضل الممارسات
الفحص قبل المعاملات
الفحص قبل المعاملات
تحقق دائمًا من الرصيد الكافي قبل بدء المعاملات
// ✅ Good
const balance = await getBalance();
if (balance >= requiredAmount) {
await sendTopUp(...);
}
// ❌ Bad
await sendTopUp(...); // Might fail with NO_BALANCE error
التخزين المؤقت الذكي
التخزين المؤقت الذكي
خزّن الرصيد مؤقتًا لمدة 30 إلى 60 ثانية لتقليل استدعاءات API
// Cache balance but invalidate after transactions
const balance = await balanceCache.getBalance();
await sendTopUp(...);
balanceCache.invalidateCache(); // Refresh after transaction
معالجة الأخطاء بلطف
معالجة الأخطاء بلطف
نفّذ معالجة أخطاء مناسبة
async function getSafeBalance() {
try {
const response = await fetch('https://api.oneclickdz.com/v3/account/balance', {
headers: { 'X-Access-Token': API_KEY }
});
const data = await response.json();
if (!data.success) {
console.error('Balance check failed:', data.error);
return null;
}
return data.data.balance;
} catch (error) {
console.error('Network error:', error);
return null;
}
}
مراقبة الرصيد المنخفض
مراقبة الرصيد المنخفض
إعداد تنبيهات للرصيد المنخفض
const LOW_BALANCE_THRESHOLD = 1000;
async function checkAndAlert() {
const balance = await getBalance();
if (balance < LOW_BALANCE_THRESHOLD) {
await sendAlert({
type: 'low_balance',
balance: balance,
message: `Balance is low: ${balance} DZD`
});
}
}
استجابات الخطأ
401 - غير مصرح
401 - غير مصرح
{
"success": false,
"error": {
"code": "INVALID_ACCESS_TOKEN",
"message": "The provided access token is invalid"
},
"requestId": "req_abc123"
}
500 - خطأ داخلي في الخادم
500 - خطأ داخلي في الخادم
{
"success": false,
"error": {
"code": "INTERNAL_SERVER_ERROR",
"message": "Developer was notified and will check shortly"
},
"requestId": "req_abc123"
}
Endpoints ذات الصلة
قائمة المعاملات
عرض سجل المعاملات
إرسال شحن جوال
إرسال شحن جوال
⌘I

