عرض الاتصالات

اعرض الحسابات الاجتماعية المتصلة مع معلومات المنصة وحالة التوكن.

الطلب

استرجع كل الحسابات الاجتماعية المتصلة للمستخدم المُصادَق. تُستبعد الحسابات المفصولة تلقائياً.

الصلاحية المطلوبة: posts:read

معاملات الاستعلام

limitintegerOptional

Default: 20

أقصى عدد اتصالات تُعاد لكل صفحة. المدى: 1–50.

offsetintegerOptional

Default: 0

عدد الاتصالات المراد تخطّيها. يُستخدم للصفحات.

platformstringOptional

تصفية بالمنصة. القيم: TWITTER، INSTAGRAM، LINKEDIN، FACEBOOK، TIKTOK، YOUTUBE، PINTEREST، SNAPCHAT. غير حسّاس لحالة الأحرف.

مثال طلب

curl "https://app.ewasl.com/api/v1/connections" \
  -H "Authorization: Bearer ewasl_YOUR_API_KEY"

curl "https://app.ewasl.com/api/v1/connections?platform=twitter" \
  -H "Authorization: Bearer ewasl_YOUR_API_KEY"

الاستجابة

يعيد قائمة مقسّمة على صفحات من كائنات الاتصال.

dataarray

قائمة كائنات الاتصال.

metaobject

بيانات الصفحات مع الحقول total و offset و limit و next.

الاستخدام

حقل id من كل اتصال هو ما تمرّره كـ accountIds عند إنشاء المنشورات. مثلاً:

{
  "content": "Hello world!",
  "accountIds": ["id-from-connections-endpoint"],
  "publishNow": true
}

Response Example

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "platform": "twitter",
      "accountId": "123456789",
      "accountName": "@ewasl_official",
      "status": "connected",
      "expiresAt": "2026-06-01T00:00:00Z",
      "connectedAt": "2026-01-15T10:00:00Z"
    },
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "platform": "linkedin",
      "accountId": "urn:li:organization:12345",
      "accountName": "eWasl Company Page",
      "status": "connected",
      "expiresAt": null,
      "connectedAt": "2026-01-15T10:05:00Z"
    },
    {
      "id": "7cb8c921-0ebe-22e2-91c5-11d15fe541d9",
      "platform": "instagram",
      "accountId": "987654321",
      "accountName": "ewasl.social",
      "status": "expired",
      "expiresAt": "2026-02-28T00:00:00Z",
      "connectedAt": "2026-01-15T10:10:00Z"
    }
  ],
  "meta": {
    "total": 3,
    "offset": 0,
    "limit": 20,
    "next": null
  }
}