Linework Open API · v1
ابنِ على Linework
واجهة REST API بسيطة لأتمتة حسابك على Linework: انشر المنشورات والقصص، وتواصل مع مجتمعك، وأدِر متجرك على Bloop، وردّ على العملاء في الدردشة.
هل تستخدم تطبيق Linework؟ يشرح دليل تطبيق Linework كل ميزات التطبيق خطوة بخطوة: الحساب، وSpiral، والدردشة، وMeet، وBloop، والمحفظة، وLinework Fans.
ما الذي يمكنك بناؤه#
روبوتات النشر
ارفع الصور والفيديوهات، وانشر المنشورات والقصص، وعدّلها أو احذفها.
المجتمعأدوات المجتمع
اقرأ التعليقات على منشوراتك، وردّ عليها، وأضف إعجابًا، وتابع الآخرين.
Bloopأتمتة المتجر
زامن المنتجات والمخزون من أنظمتك، واقرأ الطلبات وحدّدها كمشحونة.
الدردشةروبوتات الدعم
ردّ على الأشخاص الذين يراسلونك، دون إرسال رسائل مزعجة لأي أحد.
تعمل الواجهة نيابةً عن حسابك أنت: يُنفَّذ كل طلب باسم المستخدم الذي أنشأ مفتاح API، وبالصلاحيات (نطاقات الصلاحية، scopes) المختارة لذلك المفتاح. المدفوعات والمحفظة والرموز (tokens) غير متاحة عبر الواجهة.
البدء السريع في 3 خطوات#
- اطلب وصول المطوّرين. في تطبيق الويب من Linework افتح الإعدادات ← المطوّرون وأخبرنا بما تريد بناءه (حالة الاستخدام، الموقع الإلكتروني، اسم الروبوت). نراجع كل طلب.
- أنشئ مفتاح API. بعد الموافقة، أنشئ مفتاحًا من الصفحة نفسها واختر نطاقات الصلاحية الخاصة به. يبدأ المفتاح بـ
lwk_ويُعرض مرة واحدة فقط: احفظه في مكان آمن. - أرسل طلبك الأول.
curl https://api.linework.app/open/v1/me \ -H "Authorization: Bearer $LINEWORK_API_KEY"const res = await fetch("https://api.linework.app/open/v1/me", { headers: { Authorization: `Bearer ${process.env.LINEWORK_API_KEY}` }, }); console.log(await res.json());import os, requests r = requests.get( "https://api.linework.app/open/v1/me", headers={"Authorization": f"Bearer {os.environ['LINEWORK_API_KEY']}"}, ) print(r.json())
الأساسيات في لمحة#
| العنصر | القيمة |
|---|---|
| عنوان URL الأساسي | https://api.linework.app/open/v1 |
| المصادقة | Authorization: Bearer lwk_… — التفاصيل |
| التنسيق | JSON، حقول بصيغة camelCase، معرّفات نصية، تواريخ ISO 8601 (UTC) |
| حدّ المعدّل | 120 طلبًا في الدقيقة لكل مفتاح — الحدود والحصص اليومية |
| ترقيم الصفحات | قائم على المؤشر (cursor): ?limit=&cursor= → { data, next_cursor } — التفاصيل |
| الأخطاء | { "error": { "code", "message" } } — رموز الأخطاء |
| ملف OpenAPI | /openapi/linework-open-v1.yaml |
التزم بالقواعد. يجب أن تلتزم الروبوتات على Linework بقواعد المجتمع وشروط استخدام API. لا رسائل مزعجة، ولا استخراج للبيانات (scraping)، ولا انتحال للشخصية. تُلغى المفاتيح التي تخالف القواعد.