开发者与内容分发

求助希望网提供只读公开 API 与 RSS，便于 NGO、记者与志愿者发现紧急求助。

公开 API v1

• GET https://needhelp.info/api/v1/posts — 列出进行中的帖子（可选 ?country= & ?urgency= & ?limit=）
• GET https://needhelp.info/api/v1/posts/{id} — 按 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 地图点（仅 lat/lng，无精确地址）
• GET https://needhelp.info/api/oembed?url={post_url} — oEmbed
• https://needhelp.info/embed/request/{id} — iframe embed card

Webhook（管理）

注册 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 使用条款（摘要）

仅用于人道信息发现与引用。禁止骚扰、人肉搜索、商业垃圾与转售个人数据。遵守速率限制。公开 API 不含精确联系方式与受限位置。详见 docs/openapi/needhelp-v1.yaml。

打开 RSS →

伙伴冷启动运营包: see repository docs/COLD_START_PLAYBOOK.md and docs/HELP_EFFECTIVENESS_ROADMAP.md.