سرد القنوات
GET /public/v1/integrationsيعيد كل قناة مربوطة بمؤسستك. ومن هنا تأتي معرفات التكامل، لذا يستدعيه معظم من يبنون على API أولًا ويخزنون نتيجته مؤقتًا.
إن كنت تفعل ذلك من التطبيق، فراجع ربط قنواتك. وهذه
العملية متاحة أيضًا بالأمر sharek integrations:list في
أداة CLI من شارك، وبالأداة integrationList في خادم MCP من
شارك.
معاملات الاستعلام
Section titled “معاملات الاستعلام”| المعامل | مطلوب | الوصف |
|---|---|---|
group |
لا | معرف علامة تجارية من سرد العلامات التجارية. يعيد القنوات المسندة إلى تلك العلامة التجارية فقط. |
curl -H "Authorization: your-api-key" \ https://dash.sharek.app/api/public/v1/integrationsمحصورًا في علامة تجارية واحدة:
curl -H "Authorization: your-api-key" \ "https://dash.sharek.app/api/public/v1/integrations?group=group-id"الاستجابة
Section titled “الاستجابة”مصفوفة، لا غلاف:
[ { "id": "channel-id", "name": "Sharek on X", "identifier": "x", "picture": "https://example.com/avatar.png", "disabled": false, "profile": "sharekapp", "customer": { "id": "group-id", "name": "Acme Corp" } }]| الحقل | الوصف |
|---|---|
id |
معرف التكامل. وهو ما تقصده كل عملية أخرى بكلمة «قناة». |
name |
الاسم الذي أعطيته للقناة في شارك، أو اسم الحساب على المنصة إن لم تغير اسمها. وسرد المنشورات يعيد دائمًا الاسم القادم من المنصة، فقد يختلف الاثنان. |
identifier |
المزود، مثل x أو linkedin أو instagram. وهذه هي القيمة التي تذهب في settings.__type الخاص بالمنشور. |
picture |
عنوان الصورة الرمزية، أو null. |
disabled |
true حين تكون القناة معطلة. والقناة المعطلة لا تنشر. |
profile |
اسم المستخدم للحساب على المنصة (handle)، حيثما أتاحه المزود. |
customer |
العلامة التجارية التي تنتمي إليها هذه القناة، أو غائب حين لا تنتمي إلى أي علامة تجارية. |
ملاحظات
Section titled “ملاحظات”- القنوات المحذوفة مستبعدة. والمعطلة مضمنة بـ
disabled: true، فرشح عليها بنفسك إن كنت تريد القنوات القابلة للنشر فقط. - قيم
identifierهنا هي بالضبط أسماء المزودين الواردة في القنوات التي يوفرها شارك، وفيها رابط صفحة إعدادات كل قناة. - تسمي API العلامات التجارية
groupفي هذا الاستعلام، وgroups في المسار، وcustomerفي الحقول. وكلها الشيء نفسه، والتطبيق يسميها العلامات التجارية. - قيمة
groupمجهولة ليست خطأً. فهي ببساطة لا تطابق شيئًا وتعيد[].