Skip to content
YAS.SH
INTEGRATIONS

Plays well with your stack

Because every feature is API-first, integrating yas.sh is a matter of HTTP calls. Here are the patterns teams use most — plus the full API reference.

Developer Note: These are integration patterns using our REST API and UTM builder — not first-party marketplace plugins. Every integration below can be implemented cleanly via HTTP requests.

The universal integration: the API

# Create a link from any system
curl -X POST https://yas.sh/api/v1/links \
  -H "Authorization: Bearer yas_live_..." \
  -H "Content-Type: application/json" \
  -d '{"originalUrl":"https://example.com","customAlias":"launch"}'

# → { "shortCode": "launch", "url": "https://yas.sh/launch", ... }

Want a first-party integration for your platform? Tell us about it →

عن تكاملات YAS.SH

تربط التكاملات YAS.SH بالأنظمة التي تشغّلها بالفعل: webhooks لتسليم الأحداث، والواجهة البرمجية REST للاستدعاء المباشر، وحزمة SDK للوصول المُنمَّط من داخل التطبيق. وتوضّح هذه الصفحة ما يناسبه كل مسار وما يكلّفه من تعقيد تشغيلي.

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

مسارات التكامل

  • الواجهة البرمجية REST

    استدعاءات HTTP مباشرة بمدخلات ومخرجات JSON، موثّقة لكل مسار بأمثلة قابلة للتشغيل.

  • Webhooks

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

  • SDK

    عميل مُنمَّط لكود التطبيق يغلّف المصادقة وإعادة المحاولة ومعالجة الأخطاء.

التحقق من توقيع الـ webhook

توقَّع حمولات webhook بخوارزمية HMAC على جسم الطلب الخام. تحقق من التوقيع مقابل البايتات كما وصلت تمامًا وقبل أي تحليل JSON، لأن إعادة التسلسل تغيّر المسافات وترتيب المفاتيح وبالتالي تغيّر التوقيع. وأداة HMAC Generator في الموقع تعيد إنتاج العملية إذا احتجت إلى تشخيص عدم تطابق.

أسئلة شائعة

كيف أتحقق من توقيع webhook؟

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

ماذا يحدث إذا كانت نقطتي معطلة؟

يُعاد التسليم مع تباعد زمني لمدة محدودة. أما الإخفاقات المستمرة فتظهر في لوحة التحكم بدل إعادة المحاولة إلى ما لا نهاية.

هل توجد بيئة اختبار؟

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

اسأل مساعد YAS
🍪 ملفات الارتباط والخصوصية. ملفات ضرورية لتسجيل الدخول واللغة والسمة. قد يستخدم Google AdSense ملفات للإعلانات بعد اختيار «قبول الكل». يعمل reCAPTCHA على صفحات تسجيل الدخول والتواصل. كيفية استخدام Google للبيانات: https://policies.google.com/technologies/partner-sites سياسة الكوكيز · سياسة الخصوصية.
الإعدادات