مفاتيح API والمصادقة
يتيح مفتاح API لشيفرتك الخاصة ولحزم Posty5 البرمجية وn8n ومساعدات الذكاء الاصطناعي العمل مع حسابك في Posty5. تشرح هذه الصفحة كيف تعمل المفاتيح، وتحيل إليها صفحات المطورين الأخرى بدلًا من تكرار ذلك.
احصل على حساب مطوّر
Section titled “احصل على حساب مطوّر”مفاتيح API ميزة خاصة بحسابات المطورين. الترقية مجانية وتسري فورًا، ولا تغيّر خطتك ولا رصيدك.
-
في لوحة تحكم Posty5، افتح إعدادات الحساب واختر مفاتيح API.
-
اختر الترقية إلى حساب مطوّر. يُعاد تحميل الصفحة وتظهر مفاتيح API وطرق الربط مع Posty5.
افتح مفاتيح API في لوحة التحكم
أنشئ مفتاحًا
Section titled “أنشئ مفتاحًا”-
في صفحة مفاتيح API، اختر إنشاء مفتاح API.
-
أعطِ المفتاح اسمًا يدل على مكان استخدامه، مثل نموذج التواصل في الموقع. الاسم لك وحدك.
-
اختر نطاق السجلات الخاص به (موضّح أدناه) ثم اختر إنشاء. يظهر المفتاح الجديد مع زر للنسخ.
لا يُعرض المفتاح مرة واحدة فقط. تعرض القائمة كل مفتاح مخفيًا جزئيًا، ويَنسخ زر النسخ المفتاح كاملًا متى احتجت إليه. يمكنك إعادة تسمية المفتاح أو تغيير نطاق سجلاته من إجراءاته في القائمة.
أرسل المفتاح مع كل طلب
Section titled “أرسل المفتاح مع كل طلب”أرسل المفتاح في هذه الترويسة مع كل طلب إلى واجهة Posty5 البرمجية —
- تعمل الواجهة البرمجية على
للتحقق من مفتاح، استدعِ المسار الذي يصفه. يجيب بالمفتاح وصاحبه والخطة والرصيد الذي يمكن للحساب إنفاقه. أما المفتاح الملغى أو غير المعروف فيحصل على 401.
curl https://api.posty5.com/api/api-key/current \ -H "X-API-Key: YOUR_API_KEY"تستخدم الحزم البرمجية وعُقد n8n المفتاح نفسه.
| العميل | أين يوضع المفتاح | اقرأ المزيد |
|---|---|---|
| JavaScript / TypeScript | new HttpClient({ apiKey: "YOUR_API_KEY" }) | npm-sdk |
| .NET | new Posty5Options { ApiKey = "YOUR_API_KEY" } | dotnet-sdk |
| n8n | بيانات اعتماد Posty5 API، في حقل API Key | n8n-nodes |
حدّد ما يمكن للمفتاح رؤيته
Section titled “حدّد ما يمكن للمفتاح رؤيته”لكل مفتاح نطاق سجلات، وهو يحدد أيّ سجلاتك يمكن للمفتاح عرضها وتعديلها.
| نطاق السجلات | ما يمكن للمفتاح عرضه وتعديله |
|---|---|
| السجلات التي أُنشئت بهذا المفتاح فقط | السجلات التي أنشأها هذا المفتاح فقط. تبقى السجلات التي أنشأتها في لوحة التحكم أو بمفتاح آخر خارج متناوله، فلا يتداخل تكاملان في عمل بعضهما. |
| حسابي بالكامل | كل سجل في حسابك أينما أُنشئ. يحتاج مساعد الذكاء الاصطناعي إلى هذا عادةً، لأنك تسأله عن أشياء أنشأتها بنفسك. |
يبدأ كل مفتاح جديد على خيار السجلات التي أُنشئت بهذا المفتاح فقط، وكذلك كل مفتاح أُنشئ قبل وجود هذا الإعداد. لتغييره، افتح إجراءات المفتاح واختر تغيير نطاق السجلات. ويستخدم رابط MCP الخاص بالمفتاح نطاق سجلات المفتاح نفسه.
آخر استخدام، وإلغاء المفتاح
Section titled “آخر استخدام، وإلغاء المفتاح”يعرض عمود آخر استخدام متى أرسل المفتاح آخر طلب. يُحدَّث مرة واحدة على الأكثر كل بضع دقائق، لذلك قد يبدو المفتاح المستخدم باستمرار متأخرًا ببضع دقائق.
لإلغاء مفتاح، افتح إجراءاته في القائمة واختر إلغاء ثم أكّد.
- يتوقف عن العمل فورًا، ويحصل كل تطبيق أو سكربت أو تكامل يستخدمه على 401 في طلبه التالي.
- ويتوقف رابط مساعد الذكاء الاصطناعي (MCP) الخاص به في اللحظة نفسها.
- لا يمكن التراجع عن الإلغاء. أنشئ مفتاحًا جديدًا إذا احتجت إليه مرة أخرى.
- يبقى ما أنجزه المفتاح. تظل السجلات التي أنشأها في حسابك، وتُنشر المنشورات التي جدولها في موعدها، لأن النشر المجدول لا يستخدم المفتاح.
الرصيد
Section titled “الرصيد”يكلّف الطلب المُرسل بمفتاح API ما يكلّفه الإجراء نفسه في لوحة التحكم تمامًا، ويُخصم الرصيد من الحساب المالك للمفتاح. سعر كل إجراء مذكور في صفحة رصيد الميزات
حافظ على أمان المفاتيح
Section titled “حافظ على أمان المفاتيح”- احفظ المفاتيح على خادم. لا تضع مفتاحًا أبدًا في صفحة ويب أو تطبيق جوال أو مستودع عام — فكل من يقرؤه يستطيع التصرف باسمك.
- لا يستطيع المفتاح إدارة المفاتيح. إنشاء المفاتيح وعرضها وإعادة تسميتها وإلغاؤها لا يتم إلا وأنت مسجّل الدخول إلى Posty5، لذلك لا يستطيع مفتاح مسرَّب قراءة مفاتيحك الأخرى أو إنشاء مفاتيح جديدة.
- لتدوير مفتاح، أنشئ مفتاحًا جديدًا وانقل تكاملك إليه، وتأكد من تحديث تاريخ آخر استخدام للمفتاح الجديد، ثم ألغِ المفتاح القديم.
- إذا تسرّب مفتاح، فألغِه فورًا وأنشئ مفتاحًا جديدًا.