تخطَّ إلى المحتوى

سرد القنوات

GET /public/v1/integrations

يعيد كل قناة مربوطة بمؤسستك. ومن هنا تأتي معرفات التكامل، لذا يستدعيه معظم من يبنون على API أولًا ويخزنون نتيجته مؤقتًا.

إن كنت تفعل ذلك من التطبيق، فراجع ربط قنواتك. وهذه العملية متاحة أيضًا بالأمر sharek integrations:list في أداة CLI من شارك، وبالأداة integrationList في خادم MCP من شارك.

المعامل مطلوب الوصف
group لا معرف علامة تجارية من سرد العلامات التجارية. يعيد القنوات المسندة إلى تلك العلامة التجارية فقط.
Terminal window
curl -H "Authorization: your-api-key" \
https://dash.sharek.app/api/public/v1/integrations

محصورًا في علامة تجارية واحدة:

Terminal window
curl -H "Authorization: your-api-key" \
"https://dash.sharek.app/api/public/v1/integrations?group=group-id"

مصفوفة، لا غلاف:

[
{
"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 العلامة التجارية التي تنتمي إليها هذه القناة، أو غائب حين لا تنتمي إلى أي علامة تجارية.
  • القنوات المحذوفة مستبعدة. والمعطلة مضمنة بـ disabled: true، فرشح عليها بنفسك إن كنت تريد القنوات القابلة للنشر فقط.
  • قيم identifier هنا هي بالضبط أسماء المزودين الواردة في القنوات التي يوفرها شارك، وفيها رابط صفحة إعدادات كل قناة.
  • تسمي API العلامات التجارية group في هذا الاستعلام، وgroups في المسار، وcustomer في الحقول. وكلها الشيء نفسه، والتطبيق يسميها العلامات التجارية.
  • قيمة group مجهولة ليست خطأً. فهي ببساطة لا تطابق شيئًا وتعيد [].