clickSomo
حلّ ClickSomo

الـ API

ما كاين حتى نقطة نهاية خاصة. حتى للواجهة نفسها.

أغلب المنتجات عندهم اثنين API: واحد موثّق هو الذي كيقدموه ليك، وواحد آخر هو الذي كيستعملوه شاشاتهم الخاصة، وهذا دايماً هو الأحسن، وأنت عمرك ما كيسمحولك تقربه. هنا كاين واحد برك، والواجهة هي عميل تاعه كيما أي حاجة أخرى — وهذا قيد علينا، وهو السبب الذي كل ما تريد تبنيه كيكون ممكن.

شنو كيكلف هذا القانون فعلاً

معناه أن الشاشة أحياناً خاصها تستنى الـ API يولي صحيح، بدل ما تلف عليه وتاخد حقل واحد مريح. اليوم الذي الشاشة خاصها حاجة الـ API العام ما كيقدرش يعطيها، هو اليوم الذي الـ API يكون غالط، والإصلاح هو الـ API نفسه.

المكسب هو أن ثلاثة عملاء مختلفين تماماً ما يكلفوش تقريباً حتى حاجة زيادة. خادم MCP هو عميل. بلاطة في dash-b هي عميل. السكريبت تاعك هو عميل. حتى واحد فيهم ما هو مواطن من الدرجة الثانية كيدور على سطح مصمم لشخص آخر، لأن ما كاين حتى سطح آخر يكون ثانياً له.

موثّق، ومُجرَّب

OpenAPI كيتولّد في /docs وكل مسار عنده اختبار هو المثال الموجود في التوثيق. التوثيق الذي كيتكتب منفصل عن الكود كيتباعد في شهر؛ التوثيق الذي كيفشّل البناء كيكون غالط، ما كيتباعدش.

تسجيل الدخول

حساب castomo تاعك، عبر مسار كود التفويض مع PKCE — نفس الحساب الذي كتستعمله في dash-b وباقي العائلة. صفحة ما عندهاش خادم خاص بها كتدير هذا المسار مليح بزاف؛ هذا هو الذي المسار صُمم له. للعمل من آلة لآلة، مفتاح API محدود على مشروع.

السطحapi.clicksomo.com
  • 1الناس/v1/contacts · /lists · /segments · /tags · /imports
  • 2المحتوى/v1/creatives، مع التحقق والمعاينة والعرض لكل هدف
  • 3أتمتة/v1/funnels · /funnels/:id/versions · /runs · /simulate
  • 4بث/v1/campaigns، مع الجمهور والتجسيد والجدولة والإرسال كخطوات منفصلة
  • 5الأحداث الداخلة/v1/events — أحداث التطبيق تاعك، كمُحفِّزات
  • 6التوصيل/sender-identities · /domains · /apps · /webhooks
  • 7الأرقام/v1/reports/*، و/track/* على مضيف التتبع

OpenAPI في /docs/mcp على نفس العملية

الاتفاقيات

نفس الشكل كيما كل خدمة castomo أخرى

وهذا كيهم أكثر مما كيبدو. إذا كنت كتستدعي واحد من هذوهم من قبل، فأنت عارف كيف هذا يجاوب، كيف يفشل وكيف يرقّم الصفحات.

غلاف خطأ واحد

كل فشل عنده نفس الشكل، كود ثابت ورسالة مكتوبة لشخص. حتى مسار ما كيخترع طريقة خاصة به ليكون غير راضي.

ترقيم صفحات بالمؤشر

ماشي بالإزاحات. القائمة التي كتبدل وأنت كتمشي فيها ما كتتخطاش ولا كتعاود الصفوف بصمت، وهو الذي ترقيم الإزاحات كيديه بهدوء ودايماً.

مفاتيح عدم التكرار

في كل مسار كيبدّل الحالة. عاود طلب ما متأكدش وصل، وتاخد نفس الجواب بدل جهة اتصال ثانية، أو حملة ثانية، أو إرسال ثاني.

محدود على مشروع

الرمز كيوجّه لمستأجر واحد ومشروع واحد، الاثنين معاً. أمن مستوى الصفوف مُطبَّق في قاعدة البيانات نفسها، ماشي بتذكر إضافة شرط.

Webhooks خارجة

موقّعة، معادة المحاولة بتراجع، وموصّلة مرة على الأقل — فنقطة النهاية تاعك خاصها تكون هي أيضاً غير مكررة. الأحداث هي نفس المفردات التي كتستعملها التقارير.

المحو والتصدير

جهة الاتصال كتقدر تُصدَّر أو تُمحى عبر الـ API، والمحو كيوصل لكل خدمة شقيقة عندها نسخة عبر القناة الداخلية الخاصة بالعائلة.

كل ما الواجهة تقدر تديه، POST يقدر يديه.

الأحداث هي الجزء المهم

كل شيء آخر في هذه الصفحة هو مجرد أساسيات تتوقعها. POST /v1/events هو الطريق الذي يغيّر غرض المنتج.

تطبيقك يعرف بالفعل أشياء لا يمكن لأي أداة تسويقية أن تراها: من كمل التسجيل، من دعا زميل له، من وصل للحد الأقصى، من صدّر بياناته يوم الأحد بعد الظهر. أرسل هذه كأحداث برمزك الخاص، وكل واحدة منها تصبح مُشغّلاً، وشرطاً، وشريحة.

الباقي يتبع نموذج جهة الاتصال. الأحداث تُضاف ولا تُعدّل أبداً؛ هي السجل الذي يتعلق به المنتج كله. قمع يُشغّل على حدث عرّفته أنت ليس تكاملاً — إنه نفس الآلية التي يستخدمها message_opened، باسم مختلف فيه.

حدثك يصبح قمعاًapi_event
  • 1أنت ترسلهPOST /v1/events — اسم، وجهة اتصال، حمولة، ومفتاح عدم التكرار.
  • 2يصليُضاف إلى سجل جهة الاتصال. لا شيء آخر يحتاج أن يعرف بوجوده.
  • 3قمع يبدأأي قمع مدخله يذكر ذلك الحدث، لأي جهة اتصال مؤهلة حسب مواصفات مدخله.
  • 4قمعات أخرى تتفرع عليه"هل حدث هذا الحدث في آخر 14 يوماً" هو شرط شريحة عادي.
  • iويُنهي التشغيلاتعقدة هدف تذكر نفس الحدث توقف تسلسلاً في اللحظة التي يقوم فيها الشخص بالفعل.

مصطلحاتكرمزك

حدود يستحق معرفتها قبل أن تبني

ClickSomo يخزّن ثلاثة معرّفات عنك — مستأجر، ومشروع، ومستخدم، كمعرّفات غير مقروءة — ولا شيء غير ذلك. لا كلمة سر، لا ملف شخصي، لا بطاقة، لا فاتورة. حدود الخطة تصل كأرقام: كم جهة اتصال، كم إرسال، كم توليد. مصطلحات الدفع لا تعبر ذلك الخط في أي اتجاه.

جهات اتصالك ملكك. أنت المتحكم بالبيانات؛ ونحن المعالج. لا يوجد طريق يتيح لأي منتج آخر في العائلة أن يقرأ أو يكتب قائمة جهات اتصالك، ولا مسار استيعاب يستخدمه.

إذا كنت تقيّم هذا بجدية: اقرأ /docs قبل أن تقرأ أي شيء آخر في هذا الموقع. الواجهة البرمجية هي الوصف الصادق لما يفعله المنتج، وكل ادعاء في هذه الصفحات يقابل طريقاً أو نوع عقدة تجدها هناك. عندما يتغير المخطط، تتغير هذه الصفحات.