بنجهّز صفحتك…
الدخول والأسرار
خلّي توصيلك بوايو آمن: بيانات دخول الـ API، والـ signing secret بتاعك، وإزاي تتأكد إن كل طلب جاي من وايو فعلاً.
نوعين بيانات دخول، لكل واحد شغلانة
الـ API key أو الـ Bearer token أو بيانات Basic أو OAuth بتاعتك بتخلّي وايو يدخل على خدمتك. والـ signing secret بتاع وايو بيخلّي خدمتك تتأكد إن الطلب موقّع من وايو. ولا واحد فيهم هو كلمة السر اللي بتدخل بيها وايو.
أنا محتاج WAYO_SECRET؟
| بتوصّل إزاي | مطلوب؟ |
|---|---|
| SDK Wayo.from_env() / Wayo.fromEnv() | أيوه، حتى مع REST GET. |
| API موجود من غير الـ SDK | اختياري. خليك على طريقة الدخول اللي الـ endpoint بتاعك شغال بيها. |
| وكيل شغال على OpenAI أو Claude | استخدم key المنصة المناسبة وشرح التوصيل بتاعها. |
| هرد بنفسي، أو إعلان | مش محتاج signing secret. |
هتلاقي الـ signing secret بتاع حسابك في الإعدادات ← المطوّرين. حطه على السيرفر بتاعك، وخليه بعيد عن كود الـ frontend والـ logs، واعمل restart بعد أي تغيير.
لو هتتأكد من الطلبات بنفسك
وايو بيوقّع طلبات الـ endpoint بـ Standard Webhooks. اتأكد من الـ body الأصلي في POST، أو من الـ query string زي ما هو من غير “?” في GET. لو عملت parse للـ JSON وبنيته تاني قبل التأكد، الـ bytes الموقّعة هتتغير.
الـ SDK بيتأكد من التوقيع ومن إن الوقت جوه خمس دقايق. مش بيشيل الطلبات المكررة. خلّي البحث في المخزون للقراءة بس، واستخدم الـ HTTPS deployment العادي بتاعك.