واجهة بيانات ASES — للمطوّرينASES Data API — for developers
واجهة قراءة فقط تتيح الوصول البرمجي لبيانات ASES العامة (مؤشّرات الأثر، المشاريع، الفعاليات). للحصول على مفتاح: سجّل دخولك ثم A read-only API for programmatic access to ASES public data (impact metrics, projects, events). To get a key: sign in then go to حسابي ← مفاتيح APIMy account → API keys.
خصوصية البيانات: لا تُعرَض أي بيانات شخصية عبر الواجهة إطلاقاً — البيانات عامّة ومجمّعة فقط، ووكلاء الذكاء الاصطناعي يجيبون من محتوى الموقع العام دون الوصول لبيانات الأعضاء.Data privacy: no personal data is ever exposed through the API — data is public and aggregated only, and the AI agents answer from public site content with no access to members’ data.
المصادقةAuthentication
أرسل مفتاحك في ترويسة كل طلب (HTTPS فقط):Send your key in a header on every request (HTTPS only):
curl -H "X-API-Key: ases_xxxxxxxx" https://ases.org.jo/api/v1/statsنقاط الوصولEndpoints
| Endpoint | يُرجِعReturns |
|---|---|
GET /api/v1/stats | ملخّص الأثر (أعضاء، أشجار، CO₂، مشاريع، فعاليات…)Impact overview (members, trees, CO₂, projects, events…) |
GET /api/v1/impact | أرقام النقاط والتحدّيات المجتمعيةCommunity points & challenges figures |
GET /api/v1/timeline | سلسلة زمنية شهرية لنشاط المجتمع البيئي (مجهّلة: أعداد ونقاط وتصنيف — بلا هوية) · ?months=12Monthly anonymised community-activity series (counts, points, by type — no identity) · ?months=12 |
GET /api/v1/projects | المشاريع: التصنيف، الملخّص، التقدّم (المُجمَّع/الهدف)، والصورة — بلا بيانات متبرّعينProjects: category, summary, progress (raised/goal), image — no donor data |
GET /api/v1/achievements | توثيق «قبل/بعد» لمواقع عملنا — صور قبل وبعد + وصف وتاريخ ونسبة الإنجازBefore/after field documentation — before & after images + caption, date & completion |
GET /api/v1/events | الفعاليات القادمة (عناوين وتواريخ)Upcoming events (titles & dates) |
GET /api/v1/agents | قائمة وكلاء الذكاء الاصطناعي المتاحينList of available AI agents |
POST /api/v1/ask paid | اسأل «سدير»/الوكيل المناسب سؤالاً (للباقات المدفوعة فقط — يُحاسَب بالحصّة): أرسل {"q":"…","lang":"ar"} فيرجّع {reply, agent}.Ask «Sadeer»/the right agent a question (paid plans only — metered by quota): send {"q":"…","lang":"en"}, returns {reply, agent}. |
curl -X POST -H "X-API-Key: ases_xxxxxxxx" -H "Content-Type: application/json" \
-d '{"q":"How do I save water at home?","lang":"en"}' https://ases.org.jo/api/v1/askكل الردود JSON بالشكلAll responses are JSON shaped {"ok":true,"data":{…}}. البيانات عامة ومجمّعة فقط — لا بيانات شخصية.Data is public & aggregated only — no personal data.
الباقات — اشترك الآنPlans — subscribe now
اختر باقتك واشترك مباشرة. الباقات المدفوعة تمنحك حدّاً أعلى ونقاطاً بيئية هدية.Pick your plan and subscribe directly. Paid plans give a higher limit and gift eco-points.
عند تجاوز الحدّ اليومي يُرجَع رمز 429. الباقات المدفوعة تُفعَّل بعد تأكيد الدفع، وتُضاف نقاط الهدية تلقائياً. للاستفسار:Exceeding the daily limit returns HTTP 429. Paid plans activate after payment confirmation, and gift points are added automatically. Questions: info@ases.org.jo