المنشآت والحسابات

احصل على مفتاح API

نقاط النهاية

GET/v1/establishmentsGET/v1/establishments/{id}/accountsPOST/v1/establishments/{id}/connection-links

المنشأة هي نشاط تجاري أو علامة أو مكان له شبكاته ووسائطه ومنشوراته. تضم مساحة العمل منشأة واحدة أو عدة منشآت.

الحسابات المتصلة

يعرض GET /v1/establishments/{id}/accounts الشبكات المتصلة: المنصة، والمعرّف، والاسم، والصورة الرمزية، والحالة. لا تسلّم Sofia رمز أي شبكة أبدًا.

ربط شبكة ناقصة

أنشئ رابط ربط مستضافًا ووجّه المالك إليه. الرابط صالح 30 دقيقة؛ وفي النهاية تعيده Sofia إلى redirectUrl الخاص بك عندما تتعرف على أصله.

bash
curl -X POST https://api.sofia-post.com/api/v1/establishments/$ESTABLISHMENT_ID/connection-links \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"platform":"linkedin","redirectUrl":"https://app.example.com/sofia/connected"}'

الشبكة المتصلة أصلًا تُجاب بـ 409 account_already_connected؛ والشبكة التي لا تقدمها Sofia تُجاب بـ 422 platform_not_offered.