البدء
توفر واجهة برمجة تطبيقات الميزانية وصولاً برنامج يًا إلى بيانات الميزانية. تُرجع جميع نقاط النهاية استجابات بتنسيق JSON وتدعم معلمات الاستعلام المختلفة للتصفية وترقيم الصفحات.
صيغة الاستجابة
يتم إرجاع جميع الردود بتنسيق JSON مع رموز حالة HTTP المناسبة.
الوصول
حاليًا، لا تتطلب واجهة API هذه مصادقة للوصول إلى البيانات المفتوحة. جميع نقاط النهاية متاحة للجمهور.
ملاحظة
قد يتم تطبيق حد لمنع إساءة الاستخدام. يرجى الاتصال بنا إذا كنت بحاجة إلى حدود أعلى.
إجماليات الميزانية
استرجاع أرقام الميزانية الإجمالية بما في ذلك النفقات والموارد لجميع السنوات، وتغطية الميزانية الرئيسية والميزانيات التكميلية.
GET
/budget/api/totals/
Parameters
Parameter
النوع
الوصف
year
integer
تصفية حسب السنة المحددة
include_complementary
boolean
تضمين الميزانيات التكميلية
الاستجابة
تم تنسيق نص الاستجابة JSON بالهيكل التالي:
الحقل
النوع
الوصف
year
integer
سنة الميزانية
total_expenses
number
إجمالي النفقات
total_resources
number
إجمالي الموارد
balance
number
رصيد الميزانية
أمثلة
CURL
PYTHON
NODE.JS
مثال على الطلب
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/totals/" \
-H "Accept: application/json"
مع
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/totals/?year=2024&limit=10" \
-H "Accept: application/json"
مثال على الطلب
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/totals/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
مع
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/totals/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
مثال على الطلب
نسخ
const fetch = require('node-fetch');
const url = "https://budget.marsad.tn/budget/api/totals/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
فئات الميزانية
استرجاع بيانات الميزانية المنظمة حسب الفئات، بما في ذلك النفقات والموارد.
GET
/budget/api/budget-categories/
Parameters
Parameter
النوع
الوصف
year
integer
تصفية حسب سنة الميزانية
type
string
تصفية حسب النوع: 'نفقة' أو 'مورد'
الاستجابة
تم تنسيق نص الاستجابة JSON بالهيكل التالي:
الحقل
النوع
الوصف
category
string
اسم الفئة
expenses
number
إجمالي النفقات في الفئة
resources
number
إجمالي الموارد في الفئة
أمثلة
CURL
PYTHON
NODE.JS
مثال على الطلب
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/budget-categories/" \
-H "Accept: application/json"
مع
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/budget-categories/?year=2024&limit=10" \
-H "Accept: application/json"
مثال على الطلب
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/budget-categories/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
مع
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/budget-categories/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
مثال على الطلب
نسخ
const fetch = require('node-fetch');
const url = "https://budget.marsad.tn/budget/api/budget-categories/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
النفقات
استرجاع نفقات الميزانية مع هيكل هرمي اختياري. تتيح لك هذه النقطة استكشاف بيانات النفقات على مستويات مختلفة من التفاصيل.
GET
/budget/api/expenses/
Parameters
Parameter
النوع
الوصف
year
integer
تصفية النفقات حسب سنة الميزانية
hierarchy
boolean
إرجاع الهيكل الهرمي إذا كان صحيحًا
organization
integer
تصفية حسب معرف المنظمة
limit
integer
عدد النتائج المطلوب إرجاعها لكل صفحة
offset
integer
الفهرس الأولي الذي يتم منه إرجاع النتائج
الاستجابة
تم تنسيق نص الاستجابة JSON بالهيكل التالي:
الحقل
النوع
الوصف
id
integer
معرف سجل النفقة
year
integer
سنة الميزانية
amount
number
مبلغ النفقة
category
string
فئة النفقة
organization
object
تفاصيل المنظمة المرتبطة
أمثلة
CURL
PYTHON
NODE.JS
مثال على الطلب
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/expenses/" \
-H "Accept: application/json"
مع
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/expenses/?year=2024&limit=10" \
-H "Accept: application/json"
مثال على الاستجابة
نسخ
[
{
"id": 1,
"year": 2024,
"amount": 150000.00,
"category": "Personnel",
"organization": {
"id": 1,
"name": "Department of Finance"
}
}
]
مثال على الطلب
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/expenses/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
مع
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/expenses/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
مثال على الطلب
نسخ
const fetch = require('node-fetch');
const url = "https://budget.marsad.tn/budget/api/expenses/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
الموارد
استرجاع موارد الميزانية مع هيكل هرمي اختياري. تمثل الموارد الإيرادات ومصادر التمويل.
GET
/budget/api/resources/
Parameters
Parameter
النوع
الوصف
year
integer
تصفية الموارد حسب سنة الميزانية
hierarchy
boolean
إرجاع الهيكل الهرمي إذا كان صحيحًا
limit
integer
عدد النتائج المطلوب إرجاعها لكل صفحة
offset
integer
الفهرس الأولي الذي يتم منه إرجاع النتائج
الاستجابة
تم تنسيق نص الاستجابة JSON بالهيكل التالي:
الحقل
النوع
الوصف
id
integer
معرف سجل المورد
year
integer
سنة الميزانية
amount
number
مبلغ المورد
source
string
مصدر أو نوع المورد
أمثلة
CURL
PYTHON
NODE.JS
مثال على الطلب
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/resources/" \
-H "Accept: application/json"
مع
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/resources/?year=2024&limit=10" \
-H "Accept: application/json"
مثال على الطلب
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/resources/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
مع
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/resources/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
مثال على الطلب
نسخ
const fetch = require('node-fetch');
const url = "https://budget.marsad.tn/budget/api/resources/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
قائمة المنظمات
استرجاع قائمة المنظمات مع تفاصيلها بما في ذلك الاسم والرمز ومعلومات الميزانية المرتبطة.
GET
/budget/api/organization/
Parameters
Parameter
النوع
الوصف
year
integer
تصفية المنظمات حسب سنة الميزانية
limit
integer
عدد النتائج المطلوب إرجاعها لكل صفحة
offset
integer
الفهرس الأولي الذي يتم منه إرجاع النتائج
الاستجابة
تم تنسيق نص الاستجابة JSON بالهيكل التالي:
الحقل
النوع
الوصف
id
integer
معرف فريد للمنظمة
name
string
اسم المنظمة
code
string
رمز المنظمة
أمثلة
CURL
PYTHON
NODE.JS
مثال على الطلب
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/organization/" \
-H "Accept: application/json"
مع
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/organization/?year=2024&limit=10" \
-H "Accept: application/json"
مثال على الاستجابة
نسخ
[
{
"id": 1,
"name": "Department of Finance",
"code": "FIN001"
}
]
مثال على الطلب
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/organization/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
مع
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/organization/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
مثال على الطلب
نسخ
const fetch = require('node-fetch');
const url = "https://budget.marsad.tn/budget/api/organization/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
إحصائيات المنظمات
استرجاع المعلومات الإحصائية والبيانات المجمعة للمنظمات.
GET
/budget/api/organization/stats/
Parameters
Parameter
النوع
الوصف
year
integer
تصفية الإحصائيات حسب سنة الميزانية
organization_id
integer
تصفية حسب معرف منظمة محدد
الاستجابة
تم تنسيق نص الاستجابة JSON بالهيكل التالي:
الحقل
النوع
الوصف
organization_id
integer
معرف المنظمة
total_expenses
number
إجمالي مبلغ النفقات
total_resources
number
إجمالي مبلغ الموارد
أمثلة
CURL
PYTHON
NODE.JS
مثال على الطلب
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/organization/stats/" \
-H "Accept: application/json"
مع
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/organization/stats/?year=2024&limit=10" \
-H "Accept: application/json"
مثال على الطلب
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/organization/stats/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
مع
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/organization/stats/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
مثال على الطلب
نسخ
const fetch = require('node-fetch');
const url = "https://budget.marsad.tn/budget/api/organization/stats/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
الديون
استرجاع معلومات الديون حسب المصدر والسنة.
GET
/budget/api/debt/
Parameters
Parameter
النوع
الوصف
year
integer
تصفية بيانات الديون حسب السنة
parent
string
تصفية حسب مصدر الدين الأصلي (استخدم 'null' لمصادر المستوى الأعلى)
الاستجابة
تم تنسيق نص الاستجابة JSON بالهيكل التالي:
الحقل
النوع
الوصف
year
integer
سنة سجل الدين
debt_origin
object
معلومات مصدر الدين (المعرف، الأصل، الاسم)
value
number
قيمة الدين بالمليون دينار تونسي
أمثلة
CURL
PYTHON
NODE.JS
مثال على الطلب
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/debt/" \
-H "Accept: application/json"
مع
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/debt/?year=2024&limit=10" \
-H "Accept: application/json"
مثال على الطلب
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/debt/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
مع
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/debt/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
مثال على الطلب
نسخ
const fetch = require('node-fetch');
const url = "https://budget.marsad.tn/budget/api/debt/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
الدين المستحق
استرجاع معلومات الدين المستحق - المبلغ الإجمالي من المال الذي لا يزال مستحقًا ولم يتم سداده بعد، بما في ذلك المبلغ الأصلي المتبقي والفوائد المتراكمة والرسوم المرتبطة.
GET
/budget/api/outstanding-debt/
Parameters
Parameter
النوع
الوصف
year
integer or 'last'
تصفية حسب السنة أو استخدم 'last' لأحدث سنة
الاستجابة
تم تنسيق نص الاستجابة JSON بالهيكل التالي:
الحقل
النوع
الوصف
year
integer
سنة سجل الدين المستحق
outstanding_debt
number
المبلغ الإجمالي للدين المستحق بالمليون دينار تونسي (المبلغ الأصلي المتبقي والفوائد والرسوم)
gdp
number
الناتج المحلي الإجمالي بالمليون دينار تونسي
value
number
الدين المستحق كنسبة مئوية من الناتج المحلي الإجمالي
أمثلة
CURL
PYTHON
NODE.JS
مثال على الطلب
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/outstanding-debt/" \
-H "Accept: application/json"
مع
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/outstanding-debt/?year=2024&limit=10" \
-H "Accept: application/json"
مثال على الطلب
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/outstanding-debt/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
مع
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/outstanding-debt/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
مثال على الطلب
نسخ
const fetch = require('node-fetch');
const url = "https://budget.marsad.tn/budget/api/outstanding-debt/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
العجز
استرجاع معلومات العجز في الميزانية بما في ذلك القيم المطلقة والنسبة المئوية بالنسبة للناتج المحلي الإجمالي.
GET
/budget/api/deficit/
الاستجابة
تم تنسيق نص الاستجابة JSON بالهيكل التالي:
الحقل
النوع
الوصف
year
integer
سنة الميزانية
value
number
القيمة المطلقة للعجز بالمليون دينار تونسي
percent
number
العجز كنسبة مئوية من الناتج المحلي الإجمالي
gdp
number
الناتج المحلي الإجمالي بالمليون دينار تونسي
أمثلة
CURL
PYTHON
NODE.JS
مثال على الطلب
نسخ
curl -X GET "https://budget.marsad.tn/budget/api/deficit/" \
-H "Accept: application/json"
مثال على الطلب
نسخ
import requests
url = "https://budget.marsad.tn/budget/api/deficit/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
مثال على الطلب
نسخ
const fetch = require('node-fetch');
const url = "https://budget.marsad.tn/budget/api/deficit/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));