کلیدهای API
یک کلید برای هر کار، و نه بیشتر.
به هر سرویس کلید خودش را بدهید، فقط با مجوزها و فرستندههایی که لازم دارد. هر فراخوانیاش ثبت میشود.
خلاصه
کلید API چیست؟
رمزی که کد شما با هر درخواست میفرستد. میگوید فراخوانی برای کدام فضای کاری است و اجازه چه کاری دارد.
32
مجوز برای انتخاب
25
دامنه کامل در یک محدوده ارسال
3,650
روز، طولانیترین انقضا
چطور کار میکند
نقش بهعنوان سقف
یک نقش پیوست کنید تا کلید هرگز بیش از آنچه اجازه میدهد نتواند. GET /ping نشان میدهد کلید چه میخواهد و نقش چه برایش گذاشته است.
محدود کنید به نام چه کسی بفرستد
تا 25 دامنه کامل و 50 نشانی تکی. فرستندهای بیرون از آنها 403 میگیرد.
هر فراخوانی در سابقه
روش، مسیر، وضعیت، خطا و مدت هر درخواست، با پرکارترین مسیرها و اینکه چقدر خطا میدهند.
ببینید یک کلید چه میتواند
GET /ping هیچ مجوزی نمیخواهد و دامنه دسترسی کلید را برمیگرداند.
{ "ok": true, "keyId": "4c1b257a66287fd113bd89d0", "mode": "live", "scopes": ["emails:send", "templates:write", "members:write"], "roleId": "role_2b81de079c1f0a4b7e05d386", "grantedScopes": ["emails:send", "templates:write"], "workspaceId": "10417196-e324-4283-af98-66ec62167c47"}چه به دست میآورید
امروز در محصول
چرخش در جا
رمزی تازه، با همان شناسه، مجوزها و تاریخچه.
باطل، نه حذف
به فراخوانی بعدی revoked_api_key گفته میشود.
انقضای داخلی
برای کلید تاریخ انقضا بگذارید، تا ده سال جلوتر.
روشهای خوب
بیشترین بهره از آن
- 01
یک کلید برای هر سرویس
آنوقت یک نشت فقط یک یکپارچهسازی را هزینه دارد، نه همه را.
- 02
کمترین را بدهید
با emails:send شروع کنید و وقتی فراخوانیای لازم داشت مجوز بیفزایید.
- 03
خطاها را زیر نظر بگیرید
پس از هر استقرار، گزارش درخواستها را روی فراخوانیهای ناموفق فیلتر کنید.
وضعیت فعلی
خوب است بدانید
- بدون فهرست IP مجاز
- هنوز نمیتوان کلید را به نشانی سرورهایتان گره زد.
- بدون کلید آزمایشی
- فقط کلیدهای oe_live_ ساخته میشوند، پس هر ارسال واقعی است.
- بدون گزارش از طریق API
- گزارش درخواستها در برنامه خوانده میشود، نه از یک مسیر REST.
پرسشها
اغلب میپرسند
ادامه دهید
با اینها خوب کار میکند
شروع
دامنهی خودتان،
ایمیل خودتان.
دامنهای را به OpenEmail متصل کنید و نامههایش را در صندوق پستیای بخوانید که گرد آن ساخته شده است. طرح رایگان یک دامنه را پوشش میدهد.
