قائمة المعاملات
curl --request GET \
--url https://api.oneclickdz.com/v3/account/transactions \
--header 'X-Access-Token: <api-key>'import requests
url = "https://api.oneclickdz.com/v3/account/transactions"
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/transactions', 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/transactions",
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/transactions"
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/transactions")
.header("X-Access-Token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.oneclickdz.com/v3/account/transactions")
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
/
transactions
قائمة المعاملات
curl --request GET \
--url https://api.oneclickdz.com/v3/account/transactions \
--header 'X-Access-Token: <api-key>'import requests
url = "https://api.oneclickdz.com/v3/account/transactions"
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/transactions', 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/transactions",
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/transactions"
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/transactions")
.header("X-Access-Token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.oneclickdz.com/v3/account/transactions")
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نظرة عامة
يُرجع قائمة مرقّمة بجميع معاملات حسابك، بما فيها الإيداعات والسحوبات والشحنات والمبالغ المستردة والتحويلات.معلمات الاستعلام
integer
افتراضي:1
رقم الصفحة (الحد الأدنى: 1)
integer
افتراضي:20
العناصر في الصفحة (الحد الأدنى: 1، الحد الأقصى: 100)
string
تاريخ البدء للتصفية (تنسيق ISO 8601:
2025-10-01T00:00:00Z)string
تاريخ الانتهاء للتصفية (تنسيق ISO 8601:
2025-10-31T23:59:59Z)عند التصفية حسب التاريخ، يجب توفير معلمتَي
from و to معًا.أنواع المعاملات
دخول الأموال (زيادة)
| النوع | الوصف |
|---|---|
DEPOSIT | أموال مودعة في حسابك |
REFUND-FLEXY | استرداد من شحن هاتف محمول فاشل |
REFUND-ADSL | استرداد من شحن إنترنت فاشل |
REFUND-ORDER | استرداد من طلب بطاقة هدية ملغى |
RECEIVE | أموال مستلمة من مستخدم آخر |
POINT-EXCHANGE | نقاط محوّلة إلى رصيد |
خروج الأموال (تخفيض)
| النوع | الوصف |
|---|---|
FLEXY | معاملة شحن هاتف محمول |
ADSL | معاملة شحن إنترنت |
ORDER | طلب بطاقة هدية أو منتج |
WITHDRAW | أموال مسحوبة من الحساب |
SEND | أموال مرسلة لمستخدم آخر |
SERVICE | دفع خدمة أو رسوم |
الاستجابة
boolean
مطلوب
يشير إلى نجاح الطلب
object
مطلوب
إظهار properties
إظهار properties
array
مطلوب
مصفوفة من كائنات المعاملات
إظهار transaction object
إظهار transaction object
string
معرّف فريد للمعاملة
string
نوع المعاملة (انظر الأنواع أعلاه)
string
اتجاه العملية:
increment أو decrementnumber
مبلغ المعاملة بالدينار الجزائري
number
الرصيد قبل المعاملة
number
الرصيد بعد المعاملة
string
معرّف الكائن المرتبط (معرّف الشحن، معرّف الطلب، إلخ)
string
ملاحظة معاملة اختيارية
string
طابع زمني للمعاملة (ISO 8601)
الأمثلة
curl https://api.oneclickdz.com/v3/account/transactions?page=1&pageSize=20 \
-H "X-Access-Token: YOUR_API_KEY"
const response = await fetch(
"https://api.oneclickdz.com/v3/account/transactions?page=1&pageSize=20",
{
headers: { "X-Access-Token": "YOUR_API_KEY" },
}
);
const { data } = await response.json();
const transactions = data.items;
const pagination = data.pagination;
import requests
response = requests.get(
'https://api.oneclickdz.com/v3/account/transactions',
headers={'X-Access-Token': 'YOUR_API_KEY'},
params={'page': 1, 'pageSize': 20}
)
data = response.json()['data']
transactions = data['items']
pagination = data['pagination']
<?php
$ch = curl_init();
$url = 'https://api.oneclickdz.com/v3/account/transactions?page=1&pageSize=20';
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Access-Token: YOUR_API_KEY']);
$response = curl_exec($ch);
$data = json_decode($response, true);
$transactions = $data['data']['items'];
?>
مع التصفية بالتاريخ
curl "https://api.oneclickdz.com/v3/account/transactions?from=2025-10-01T00:00:00Z&to=2025-10-31T23:59:59Z" \
-H "X-Access-Token: YOUR_API_KEY"
const from = "2025-10-01T00:00:00Z";
const to = "2025-10-31T23:59:59Z";
const response = await fetch(
`https://api.oneclickdz.com/v3/account/transactions?from=${from}&to=${to}`,
{ headers: { "X-Access-Token": "YOUR_API_KEY" } }
);
response = requests.get(
'https://api.oneclickdz.com/v3/account/transactions',
headers={'X-Access-Token': 'YOUR_API_KEY'},
params={
'from': '2025-10-01T00:00:00Z',
'to': '2025-10-31T23:59:59Z'
}
)
مثال على الاستجابة
{
"success": true,
"data": {
"items": [
{
"type": "FLEXY",
"operation": "decrement",
"oldBalance": 2316.129999998957,
"amount": 990,
"newBalance": 1326.129999998957,
"objid": "68fe2cdd51bc170608683e3a",
"note": "MIX1000_OOREDOO - 0554926570",
"time": "2025-10-26T14:14:53.074Z",
"_id": "68fe2cdd51bc170608683e40"
},
{
"type": "REFUND-ORDER",
"operation": "increment",
"oldBalance": 316.1299999989569,
"amount": 2000,
"newBalance": 2316.129999998957,
"objid": "68fcdd7cd712569c624e05ee",
"note": "Refunded - 1 - 68fcdd7cd712569c624e05ee",
"time": "2025-10-25T14:24:00.338Z",
"_id": "68fcdd80d712569c624e069d"
}
],
"pagination": {
"page": 1,
"pageSize": 5,
"totalPages": 105,
"totalResults": 521
}
},
"meta": {
"timestamp": "2025-10-29T00:35:58.852Z"
}
}
حالات الاستخدام
سجل المعاملات
اعرض سجل المعاملات للمستخدمين في تطبيقك
المحاسبة والتقارير
أنشئ تقارير ومستخرجات مالية
مطابقة الرصيد
تحقق من تغييرات الرصيد وراجع المعاملات
نشاط المستخدم
تتبع أنماط الإنفاق وسلوك المستخدمين
أفضل الممارسات
التصفح بالصفحات
التصفح بالصفحات
- ابدأ بأحجام صفحات معقولة (20 إلى 50 عنصرًا)
- نفّذ التمرير اللانهائي أو التنقل بين الصفحات
- خزّن النتائج مؤقتًا لتقليل استدعاءات API
- استخدم
pagination.totalPagesلتحديد ما إذا كانت هناك بيانات إضافية
التصفية بالتاريخ
التصفية بالتاريخ
- قدّم دائمًا معلمتَي
fromوtoمعًا - استخدم تنسيق ISO 8601 للتواريخ - حدد نطاقات زمنية مناسبة للتقارير - خذ بعين الاعتبار اختلافات المنطقة الزمنية عند التصفية
الأداء
الأداء
- خزّن بيانات المعاملات محليًا إذا أمكن - استخدم فلاتر التاريخ للحد من مجموعات النتائج
- نفّذ واجهة مستخدم مناسبة للتصفح بالصفحات - فكّر في إشعارات webhook للتحديثات الفورية
العرض للمستخدمين
العرض للمستخدمين
- اعرض نوع المعاملة بلغة سهلة للمستخدم
- اعرض المبالغ بتنسيق العملة المناسب
- أدرج الطوابع الزمنية بالمنطقة الزمنية المحلية
- ربط المعاملات بالكائنات المرتبطة (الشحنات، الطلبات)
Endpoints ذات الصلة
الحصول على الرصيد
التحقق من رصيد الحساب الحالي

