مقدمة

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

ما هي Sofia API؟

تمنح Sofia API شيفرتك البرمجية وصولًا إلى حسابك في Sofia: منشآت مساحات العمل لديك، وشبكاتها المتصلة، ومكتبة وسائطها، ومنشوراتها، وإحصاءاتها. هي واجهة REST عبر HTTPS. الطلبات والاستجابات بصيغة JSON، وكل نقطة نهاية تقع تحت عنوان أساسي واحد.

text
https://api.sofia-post.com/api/v1

ماذا تستطيع الـ API أن تفعل؟

  • نشر المنشورات: فورًا، أو في موعد محدد، أو كمسودة، على شبكة واحدة أو عدة شبكات في وقت واحد.
  • التحقق قبل النشر: تخبرك التجربة الجافة (dry run) هل ستقبل كل شبكة المنشور، ولا تكتب شيئًا.
  • إدارة الوسائط: ارفع ملفًا أو استورده من رابط URL إلى مكتبة وسائط منشأة.
  • متابعة المنشورات: اقرأ حالة كل شبكة ورابطها الدائم أو سبب الفشل. ويمكن لـ webhook موقّع أن يخبرك أيضًا.
  • قراءة الإحصاءات: أحدث الأرقام التي جمعتها Sofia لكل حساب متصل.
  • ربط الشبكات: أنشئ رابطًا مستضافًا يتيح للمالك ربط شبكة ناقصة.

لمن هي؟

لمطوّر يؤتمت مساحة العمل الخاصة به، يكفي مفتاح شخصي: أنشئه في الإعدادات › API وأرسله كرمز Bearer. أما لمنتج SaaS يتصرف نيابةً عن مستخدميه في مساحات عملهم، فسجّل عميل OAuth: يفوّض كل شخص تطبيقك على مساحة العمل التي يختارها.

الخطوات التالية