کلیدهای API و امنیت
دامنهها، فهرست IPهای مجاز، سقف هزینه روزانه، انقضا، چرخش بدون قطعی و کاری که اگر کلیدی نشت کرد باید کرد.
در این صفحه
کلید API هر کاری را که دامنههایش اجازه دهند انجام میدهد و هزینه را از موجودی شما میپردازد. با آن مثل گذرواژه رفتار کنید.
قالب کلید
کلیدها به شکل sgk_ و به دنبال آن ۴۰ حرف و رقم هستند. SmsGrab فقط اثر انگشتی از هر کلید نگه میدارد، پس کلید یک بار، هنگام ساخت یا چرخش، نمایش داده میشود و دیگر هرگز. در حسابتان فقط ابتدای آن و چهار نویسه آخرش را میبینید.
توانایی هر کلید را محدود کنید
هنگام ساخت یا ویرایش کلید میتوانید آن را محدود کنید:
| تنظیم | کارکرد |
|---|---|
| دامنهها | read برای موجودی، کاتالوگ، قیمتها، فعالسازیها و مصرف؛ read و purchase برای خرید، لغو و پایان هم |
| فهرست IP مجاز | تا ۵۰ نشانی IPv4 یا IPv6 یا بازه CIDR؛ درخواستهای نشانیهای دیگر رد میشوند |
| سقف هزینه روزانه | بیشترین مبلغی که این کلید در هر روز UTC (خالص) میتواند خرج کند؛ بیش از آن خریدها رد میشوند و چیزی کسر نمیشود |
| انقضا | تاریخی اختیاری که بعد از آن کلید کار نمیکند، حداکثر ۲ سال بعد |
برای هر اپلیکیشن یا سرور یک کلید با کمترین دامنههای لازم استفاده کنید. هر حساب میتواند تا ۱۰ کلید فعال داشته باشد.
تأیید تغییرات حساس
ساخت کلید، چرخش آن، افزودن وبهوک، عوض کردن راز وبهوک و آزادتر کردن کلید (دامنههای بیشتر، فهرست IP گستردهتر، سقف بالاتر یا انقضای دیرتر) دوباره گذرواژه و اگر تأیید دومرحلهای روشن است، کد آن را میخواهد. این تأیید ۵ دقیقه اعتبار دارد. باطل کردن کلید و سختتر کردن محدودیتها هرگز چنین چیزی نمیخواهند.
چرخش بدون قطعی
چرخش به کلید راز تازهای میدهد و تنظیمات، مصرف و وبهوکهایش را نگه میدارد. یک دوره انتقال تا ۷۲ ساعت انتخاب میکنید که در آن راز قدیمی هنوز کار میکند، تا سرورهایتان را بدون وقفه بهروز کنید.
باطل کردن
باطل کردن کلید را فوراً و برای همیشه متوقف میکند. وبهوکهایش هم خاموش میشوند.
اگر کلیدی نشت کرد
- آن را باطل کنید یا با دوره انتقال ۰ ساعت بچرخانید.
- گزارش درخواستهای کلید (۷ روز گذشته) و کیف پول را برای فعالیت ناآشنا بررسی کنید.
- کلید تازهای با فهرست IP مجاز و سقف هزینه روزانه بسازید.
چه چیزهایی ثبت میکنیم
کلیدها هرگز در هیچ گزارشی ظاهر نمیشوند. برای هر درخواست، زمان، مسیر، وضعیت، مدت و شناسه درخواست را ۷ روز نگه میداریم و شما میتوانید آنها را برای هر کلید ببینید. ساخت، چرخش و باطل کردن کلیدها در فعالیت حساب هم نمایش داده میشود و هر کلید تازه یک اعلان ایجاد میکند.
هرگز از مرورگر
API درخواستهای صفحههای وب را نمیپذیرد (CORS وجود ندارد). آن را فقط از سرورهای خودتان فراخوانی کنید.
این مقاله مفید بود؟
سپاس! خوشحالیم که کمک کرد.