يوفر Posty5 أربع طرق تكامل عملية: REST مباشرة وحزم JavaScript/TypeScript وحزم .NET وعُقد n8n. ابدأ بمفتاح مسمى ثم اختر الطبقة الأنسب لتطبيقك.
أنشئ المفتاح وسمّه
توجد API Keys and Integrations في إعدادات الحساب لحسابات Developer. أنشئ المفتاح باسم يوضح التطبيق أو المهمة حتى تستطيع التعرف عليه لاحقًا.
- أنشئ المفتاح وسمّه
- احمِ المفاتيح ودوّرها
- صادق الطلب
صادق الطلب
أرسل المفتاح في header باسم X-API-Key. يستخدم SDK العنوان https://api.posty5.com افتراضيًا ويمكنه قراءة POSTY5_API_KEY من بيئة الخادم؛ لا تضع المفتاح في كود المتصفح أو مستودع عام أو لقطة شاشة.
curl https://api.posty5.com/api/short-link \
-H "X-API-Key: $POSTY5_API_KEY"اختر طريقة التكامل
استخدم REST للتحكم المباشر، وSDK لتطبيقات Node.js المكتوبة، وحزم .NET لتطبيقات C#، وn8n للمسارات المرئية. ينشر JavaScript SDK ثماني حزم مؤكدة تشمل core وshort-link وqr-code وhtml-hosting وvariables وform-submission وsocial workspaces وsocial posts.
استخدم حزم SDK
@posty5/core@posty5/short-link@posty5/qr-code@posty5/html-hosting@posty5/html-hosting-variables@posty5/html-hosting-form-submission@posty5/social-publisher-workspace@posty5/social-publisher-post
احمِ المفاتيح ودوّرها
احتفظ بالمفاتيح على الخادم واستخدم مفتاحًا منفصلًا لكل تطبيق أو بيئة ولا تسجل قيمته. للتدوير أنشئ بديلًا وحدّث المستهلكين واختبرهم ثم احذف المفتاح القديم.
عالج الاتصال
عند فشل المصادقة افحص base URL وكتابة X-API-Key وصلاحية المفتاح. قد يعني 403 أن الحساب أو الإجراء غير مسموح، بينما تحتاج أخطاء validation إلى تصحيح البيانات.
عالج الاتصال
صادق الطلب
أرسل المفتاح في header باسم X-API-Key. يستخدم SDK العنوان https://api.posty5.com افتراضيًا ويمكنه قراءة POSTY5_API_KEY من بيئة الخادم؛ لا تضع المفتاح في كود المتصفح أو مستودع عام أو لقطة شاشة.
اختر طريقة التكامل
استخدم REST للتحكم المباشر، وSDK لتطبيقات Node.js المكتوبة، وحزم .NET لتطبيقات C#، وn8n للمسارات المرئية. ينشر JavaScript SDK ثماني حزم مؤكدة تشمل core وshort-link وqr-code وhtml-hosting وvariables وform-submission وsocial workspaces وsocial posts.
احمِ المفاتيح ودوّرها
احتفظ بالمفاتيح على الخادم واستخدم مفتاحًا منفصلًا لكل تطبيق أو بيئة ولا تسجل قيمته. للتدوير أنشئ بديلًا وحدّث المستهلكين واختبرهم ثم احذف المفتاح القديم.
عالج الاتصال
عند فشل المصادقة افحص base URL وكتابة X-API-Key وصلاحية المفتاح. قد يعني 403 أن الحساب أو الإجراء غير مسموح، بينما تحتاج أخطاء validation إلى تصحيح البيانات.
