الوكلاء والواجهة البرمجية
وكلاؤك يقترحون، وقواعد العلامة تقرّر.
تتيح الواجهة البرمجية لـ AKETRA لأدواتك ووكلائك قراءة العلامة واقتراح العمل. ويمرّ كل إجراء يقترحونه بالحارس نفسه الذي تمرّ به اقتراحات AKETRA، وتبقى القرارات بيد المسؤولين لديك.
POST /public/v1/brands/{brandId}/actions
Authorization: <API key>
{
"type": "post.publish",
"title": "Launch week teaser",
"payload": {
"integrationId": "…",
"content": "Our new model is fully autonomous."
}
}{
"observed": false,
"action": {
"status": "PROPOSED",
"autonomy": "RECOMMEND",
"holds": ["Mentions a prohibited claim: \"fully autonomous\""],
"proposedBy": "API"
}
}ما الذي يحدث للاقتراح
- 1
المراقبة
لا يُنشأ أي إجراء، وتصل الفكرة إشارةَ فرصة.
- 2
التوصية
ينتظر الإجراء مسؤولًا يعتمده أو يعدّله أو يرفضه في التطبيق.
- 3
التحضير
يُنشأ المنشور مسودةً في التقويم.
- 4
التشغيل
يُجدوَل المنشور ضمن الحدّ اليومي، أو يبقى مسودةً حين لا تقبله القناة كما كُتب.
ما الذي يوقفه الحارس
- ادعاء محظور في المنشور
- قناة تحتاج إلى انتباه
- قناة على تطبيق علامة أخرى، أو خارج تطبيق العلامة الخاص حين تشترطه
- الحدّ اليومي حين يُبلَغ
- إجراء آخر من النوع نفسه قيد التنفيذ للعلامة
في مستويَي التحضير والتشغيل، يعود الاقتراح الموقوف إلى مستوى التوصية وينتظر مسؤولًا يرى السبب.
ما الذي تستطيعه الواجهة البرمجية
القراءة
العلامات وقنواتها، وصفحة العلامة، وعقل العلامة، والأهداف، والاستقلالية، والإجراءات، والإشارات المفتوحة، وسجلّ النشاط.
الاقتراح
المنشورات وعناصر عقل العلامة والخطط، وإدارة الأهداف. وتنتظر عناصر العقل مسؤولًا يقبلها.
ما يبقى للمسؤولين
اعتماد الإجراءات ورفضها وسحبها، وتغيير الاستقلالية، وتعيين القنوات، وإدارة تطبيقات العلامة.
ابدأ
- المصادقة
- مفتاح API الخاص بمؤسستك، أو رمز OAuth، في ترويسة Authorization
- Node.js
- npm install @aketra/node
- المرجع
- وصف OpenAPI على المسار /public/v1/docs
- الحدود
- الاقتراحات، وتغييرات الأهداف والعقل، والمنشورات الجديدة: 90 في الساعة لكل مسار ومؤسسة. والقراءة بلا حدود
أسئلة
- هل يستطيع الوكيل اعتماد اقتراحاته بنفسه؟
- لا. يبقى اعتماد الإجراءات ورفضها وسحبها للمسؤولين في التطبيق، ولا مسارات لها في الواجهة البرمجية.
- هل يمرّ كل ما يفعله الوكيل بالحارس؟
- كل إجراء يقترحه عبر مسارات العلامة يمرّ به. لكن المفتاح نفسه يفتح أيضًا مسارات محرّك النشر وأدوات MCP الخاصة به، وهي تجدول المنشورات وتغيّرها وتحذفها مباشرة كما يفعل تقويم فريقك. فوجّه الوكلاء الذين تريد ضبطهم إلى مسارات العلامة.
- هل توجد Webhooks؟
- ليس لأحداث العلامة بعد. تُبلغ Webhooks محرّك النشر عن المنشورات المنشورة، ولما سوى ذلك اقرأ سجلّ نشاط العلامة أو إشاراتها المفتوحة.
- أين الواجهة البرمجية؟
- على api.aketra.co، حين يُفتح AKETRA Cloud.
المزيد عن AKETRA
ابنِ على علامات تلتزم بقواعدها.
يُفتح الوصول المبكر على مراحل، علامةً بعد علامة.