دليل API للمطورين

المصادقة

أنشئ تكاملًا بالصفحات والصلاحيات المطلوبة في لوحة التحكم. أرسل المفتاح بصيغة Bearer في ترويسة Authorization. تنتهي صلاحيته بعد سنة ويمكن تغييره أو إلغاؤه من اللوحة.

curl 'https://highfollower.com/api/v1/pages' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Accept: application/json'

مسارات API

إرسال الردود

أرسل message نصية حتى 1000 حرف. في حالة uncertain افحص البريد الوارد قبل إعادة الإرسال.

curl -X POST 'https://highfollower.com/api/v1/pages/12/conversations/CONVERSATION_KEY/replies' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"message":"Hello! How can we help?"}'

Webhook مخصص

اضبط العنوان والأحداث وأرسل حدثًا تجريبيًا. تتضمن الحمولة id وtype وapi_version وoccurred_at وplatform_page_id وplatform وdata. أحداث الرسائل والتعليقات تشمل الوارد والصادر. يشير حدث synced إلى ضرورة تحديث القائمة من API.

import hashlib, hmac, json, time

def verify_webhook(raw_body, headers, secret):
    timestamp = headers["X-HighFollower-Timestamp"]
    if abs(time.time() - int(timestamp)) > 300:
        raise ValueError("Expired webhook")
    digest = hmac.new(
        secret.encode(), timestamp.encode() + b"." + raw_body,
        hashlib.sha256,
    ).hexdigest()
    if not hmac.compare_digest(
        "sha256=" + digest, headers["X-HighFollower-Signature"]
    ):
        raise ValueError("Invalid signature")
    return json.loads(raw_body)

# Deduplicate the verified payload["id"] in your database.
# Return 2xx after durably accepting the event.

الحدود والأخطاء