數據洞察

取得 API 金鑰

端點

GET/v1/establishments/{id}/insights

period 可為 last24Hours、last7Days 或 last28Days（預設）。回應會為每個已連結帳號給出 Sofia 蒐集的最新數據。

bash
curl "https://api.sofia-post.com/api/v1/establishments/$ESTABLISHMENT_ID/insights?period=last7Days" \
  -H "Authorization: Bearer $SOFIA_API_KEY"
  • 尚未蒐集資料的帳號為 awaiting，絕不會是零。
  • 每項指標要嘛是帶 value 的 available，要嘛是帶 reason 的 unavailable；mayBeDelayed 提醒該網路較晚才會公布此數據。