تخطَّ إلى المحتوى الرئيسي
تصفّح التوثيق

Go

تحقّق من نيّات وكيل Syncanix في Go — net/http وGin وEcho وFiber — بفحص HMAC محلي على كل استدعاء أداة.

تأتي حزمة SDK للغة Go ببرمجيات وسيطة لـ net/http وGin وEcho وFiber، إضافةً إلى نواة VerifyIntent يمكنك استدعاؤها مباشرةً. سجِّلها على مسارات أدواتك واقرأ الحمولة المتحقَّق منها من سياق الطلب.

التثبيت

أضف الحزمة إلى مشروعك بمدير الحزم الخاص بلغتك.

go get github.com/syncanix-ai/syncanix-sdk-go

ضبط السرّ

تتحقق حزمة SDK من النيّات بسرّ توقيع النيّة الخاص بمستأجرك. خزّنه كمتغيّر بيئة — ولا تودعه في نظام إدارة الشيفرة أبدًا — وحمِّله حيث تسجّل حزمة SDK.

export SYNCANIX_INTENT_SECRET="your-intent-signing-secret"

التحقق من النيّات

سجِّل حزمة SDK على المسارات التي تعرض إجراءات الوكيل. فهي تتحقق من ترويسة X-Syncanix-Intent قبل تشغيل معالِجك، وترفض أي استدعاء غير صالح أو مُعاد إرساله بالرمز 403، وتسلّم معالِجك الحمولة المتحقَّق منها — بما فيها المستأجر والمستخدم الفاعلان.

r := gin.Default()
r.Use(syncanix.GinMiddleware(os.Getenv("SYNCANIX_INTENT_SECRET"), nil))

r.POST("/tools/refund", func(c *gin.Context) {
    payload, _ := c.MustGet(syncanix.GinIntentKey).(*syncanix.IntentPayload)
    c.JSON(200, gin.H{"tenantId": payload.TenantID})
})
التحقق من نيّة على مسار أداة. عند النجاح تكون الحمولة المتحقَّق منها متاحة لمعالِجك؛ وعند الفشل تعيد حزمة SDK الرمز 403 قبل أن تعمل شيفرتك.

الخطوات التالية