وثائق الـ API العامة
استخدم الـ API للوصول البرمجي لجميع مجموعات البيانات. لا يحتاج مفتاح — مجاني ومفتوح للجميع.
🌐 Base URL
https://tapneo.netlify.app/api/v1
📡 Endpoints
GET
/datasets
الحصول على قائمة بجميع مجموعات البيانات المتاحة.
// Response Example
{
"status": "success",
"count": 6,
"data": [
{
"id": "ksa-aviation-2026",
"title": "قطاع الطيران السعودي",
"rows": "248K",
"size": "MB 42"
},
...
]
}
{
"status": "success",
"count": 6,
"data": [
{
"id": "ksa-aviation-2026",
"title": "قطاع الطيران السعودي",
"rows": "248K",
"size": "MB 42"
},
...
]
}
GET
/datasets/{id}
الحصول على تفاصيل مجموعة بيانات محددة مع عينة من البيانات.
// Example
GET /datasets/ksa-aviation-2026
GET /datasets/ksa-aviation-2026
GET
/datasets/{id}/download?format=csv
تحميل مجموعة البيانات بالصيغة المطلوبة (csv, json, parquet).
GET
/dashboards
الحصول على قائمة بجميع لوحات البيانات التفاعلية.
💻 أمثلة استخدام
Python
import requests
response = requests.get("https://tapneo.netlify.app/api/v1/datasets")
data = response.json()
for dataset in data["data"]:
print(dataset["title"], "-", dataset["rows"])
response = requests.get("https://tapneo.netlify.app/api/v1/datasets")
data = response.json()
for dataset in data["data"]:
print(dataset["title"], "-", dataset["rows"])
JavaScript
const res = await fetch("https://tapneo.netlify.app/api/v1/datasets");
const { data } = await res.json();
data.forEach(ds => {
console.log(ds.title, "-", ds.rows);
});
const { data } = await res.json();
data.forEach(ds => {
console.log(ds.title, "-", ds.rows);
});
cURL
curl https://tapneo.netlify.app/api/v1/datasets | jq '.'
⚙️ حدود الاستخدام
| الحد | القيمة | ملاحظة |
|---|---|---|
| Requests / min | 60 | لكل IP |
| Requests / day | 10,000 | لكل IP |
| Max file size | 100 MB | لكل تحميل |
| Response format | JSON | افتراضي |