مفاتيح API والأمان
النطاقات، وقوائم عناوين IP المسموح بها، وحدود الإنفاق اليومية، وانتهاء الصلاحية، والتدوير دون توقف، وما تفعله إذا تسرّب مفتاح.
في هذه الصفحة
يستطيع مفتاح API فعل كل ما تسمح به نطاقاته، والدفع من رصيدك. تعامل معه ككلمة مرور.
صيغة المفتاح
تبدو المفاتيح مثل sgk_ يليه 40 حرفًا ورقمًا. يحتفظ SmsGrab ببصمة لكل مفتاح فقط، لذا يُعرض المفتاح مرة واحدة عند إنشائه أو تدويره، ولا يُعرض مجددًا أبدًا. في حسابك ترى بدايته وآخر أربعة أحرف منه فقط.
قيّد ما يستطيع كل مفتاح فعله
عند إنشاء مفتاح أو تعديله، يمكنك تقييده:
| الإعداد | ما يفعله |
|---|---|
| النطاقات | read للرصيد والكتالوج والأسعار والتفعيلات والاستخدام؛ read وpurchase للشراء والإلغاء والإنهاء أيضًا |
| قائمة IP المسموح بها | حتى 50 عنوان IPv4 أو IPv6 أو نطاق CIDR؛ تُرفض الطلبات من العناوين الأخرى |
| حد الإنفاق اليومي | أقصى ما يمكن لهذا المفتاح إنفاقه (صافيًا) في اليوم بتوقيت UTC؛ بعده تُرفض المشتريات ولا يُخصم شيء |
| انتهاء الصلاحية | تاريخ اختياري يتوقف بعده المفتاح عن العمل، بحد أقصى سنتين مقدمًا |
استخدم مفتاحًا واحدًا لكل تطبيق أو خادم، بأقل النطاقات اللازمة. يمكن أن يكون للحساب حتى 10 مفاتيح نشطة.
تأكيد التغييرات الحساسة
إنشاء مفتاح، وتدويره، وإضافة خطاف ويب، وتغيير سر خطاف ويب، وتوسيع صلاحيات مفتاح (نطاقات أكثر، أو قائمة IP أوسع، أو حد أعلى، أو انتهاء صلاحية أبعد) تطلب كلمة المرور مرة أخرى، ورمز التحقق بخطوتين إذا كان مفعّلًا. يبقى التأكيد صالحًا لمدة 5 دقائق. إبطال مفتاح وتشديد حدوده لا يطلبان ذلك أبدًا.
التدوير دون توقف
التدوير يمنح المفتاح سرًا جديدًا مع الاحتفاظ بإعداداته واستخدامه وخطافات الويب الخاصة به. تختار فترة سماح تصل إلى 72 ساعة يظل خلالها السر القديم يعمل، لتحدّث خوادمك دون انقطاع.
الإبطال
الإبطال يوقف المفتاح فورًا ونهائيًا. وتتوقف خطافات الويب الخاصة به أيضًا.
إذا تسرّب مفتاح
- أبطله، أو دوّره بفترة سماح 0 ساعات.
- تحقّق من سجل الطلبات للمفتاح (آخر 7 أيام) ومن المحفظة بحثًا عن نشاط لا تعرفه.
- أنشئ مفتاحًا جديدًا بقائمة IP مسموح بها وحد إنفاق يومي.
ما الذي نسجّله
لا تظهر المفاتيح في أي سجل. لكل طلب نحتفظ لمدة 7 أيام بالوقت والمسار والحالة والمدة ومعرّف الطلب، ويمكنك رؤيتها لكل مفتاح. إنشاء المفاتيح وتدويرها وإبطالها يظهر أيضًا في نشاط حسابك، وكل مفتاح جديد يطلق إشعارًا.
ليس من المتصفح أبدًا
لا تقبل الواجهة الطلبات من صفحات الويب (لا يوجد CORS). استدعِها من خوادمك فقط.
هل كان هذا المقال مفيدًا؟
شكرًا! يسعدنا أنه ساعدك.