⚠️ المساعدة الحقيقية لن تطلب منك مالاً أولاً.
HelpHope

المطورون والتوزيع

يوفر HelpHope واجهات قراءة فقط وRSS للمنظمات والصحفيين والمتطوعين.

API العام v1

  • GET https://needhelp.info/api/v1/posts — قائمة المنشورات النشطة (اختياري ?country= & ?urgency= & ?limit=)
  • GET https://needhelp.info/api/v1/posts/{id} — جلب منشور بالمعرّف
  • GET https://needhelp.info/feed.xml — RSS (all)
  • GET https://needhelp.info/feed/{lang} — RSS by locale
  • GET https://needhelp.info/api/v1/geojson — نقاط GeoJSON (إحداثيات فقط)
  • GET https://needhelp.info/api/oembed?url={post_url} — oEmbed
  • https://needhelp.info/embed/request/{id} — iframe embed card

Webhooks (إدارة)

سجّل نقاط HTTPS لاستلام post.created و offer.created. يتطلب x-admin-key.

POST https://needhelp.info/api/webhooks
Header: x-admin-key: YOUR_KEY
Body: { "url": "https://example.com/hook", "events": ["post.created", "offer.created"] }

شروط API (ملخص)

للاكتشاف الإنساني والاقتباس فقط. لا مضايقة ولا بيع بيانات شخصية. راجع docs/openapi/needhelp-v1.yaml.

جرّب RSS ←

دليل البدء البارد للشركاء: see repository docs/COLD_START_PLAYBOOK.md and docs/HELP_EFFECTIVENESS_ROADMAP.md.