مقدمة واجهة برمجة التطبيقات

​

عنوان URL الأساسي

https://app.flowella.io

​

المصادقة

Authorization: Bearer flo_xxxxxxxxxxxxxxxxxxxxxxxx

​

إنشاء مفتاح

1. انتقل إلى الإعدادات → مفاتيح API في تطبيق Flowella .
2. انقر على إنشاء مفتاح وأعطه اسمًا يسهل تذكره.
3. انسخ المفتاح مرة واحدة — فهو يظهر فقط عند إنشائه.

​

التحقق من المفتاح

curl https://app.flowella.io/api/v1/ping \
  -H "Authorization: Bearer flo_xxxxxxxxxxxxxxxxxxxxxxxx"

await fetch("https://app.flowella.io/api/v1/ping", {
  headers: { Authorization: `Bearer ${process.env.FLOWELLA_API_KEY}` },
});

import os, requests

requests.get(
    "https://app.flowella.io/api/v1/ping",
    headers={"Authorization": f"Bearer {os.environ['FLOWELLA_API_KEY']}"},
)

​

الأخطاء

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}

​

حدود المعدل

​

ترقيم الصفحات

• مررlimit (1–100، الافتراضي 25) وcursor اختياري.
• تحتوي الاستجابة علىitems ، وعندما يكون هناك المزيد من النتائج،nextCursor .
• مررnextCursor مرة أخرى كمعلمةcursor لجلب الصفحة التالية.
• عندما يكونnextCursor مفقودًا، فهذا يعني أنك وصلت إلى النهاية.

curl "https://app.flowella.io/api/v1/conversations?limit=50" \
  -H "Authorization: Bearer flo_xxxxxxxxxxxxxxxxxxxxxxxx"

​

التاريخ والوقت

​

أرقام الهواتف

​

القنوات

​

مواصفات OpenAPI

/api-reference/openapi.json