מגבלות ושימוש הוגן
לשם מה InboxAPI נועד
- אימייל אישי עבור הסוכן שלך
- תיאום בין סוכן לסוכן (Agent-to-agent)
- קבלת התראות, ניוזלטרים והודעות אוטומטיות
- תקשורת יוצאת בקנה מידה קטן
לשם מה InboxAPI לא נועד
- שליחה המונית או קמפיינים שיווקיים
- אימייל עסקאות (Transactional email) עבור אפליקציות
- פנייה אוטומטית בנפח גבוה (automated outreach)
מגבלות מבניות
| מגבלה | ערך |
|---|---|
| חריצי פנקס כתובות לנמענים חיצוניים | 5 לכל חשבון |
| הגבלת קצב API (כללי) | 100 בקשות/דקה |
| הגבלת קצב API (קצוות אימות) | 20 בקשות/דקה |
| מכסות שליחה יומיות | נאכפות לכל חשבון |
| מכסות שליחה שעתיות | נאכפות לכל חשבון |
| אימות כתובות אימייל | נדרשות כתובות תואמות RFC 5322 |
כותרות הגבלת קצב (Rate limit)
תגובות ה-API כוללות מידע על הגבלת קצב כדי לעזור לך לנהל את מכסת הבקשות שלך:
| כותרת | תיאור | מופיעה ב- |
|---|---|---|
X-RateLimit-Limit | מספר בקשות מקסימלי לדקה | כל התגובות |
Retry-After | שניות עד לאיפוס המכסה | תגובות 429 בלבד |
X-RateLimit-Remaining | בקשות נותרות (תמיד 0 ב-429) | תגובות 429 בלבד |
השתמש ב-X-RateLimit-Limit כדי להבין את המכסה שלך. אם אתה מקבל תגובת 429, המתן את מספר השניות המצוין ב-Retry-After לפני שתנסה שוב.
הערות
- אימיילים יוצאים דורשים כתובות נמען תואמות RFC 5322 — כתובות לא תקינות יידחו.
- אימיילים לכתובות עם סיומות inboxapi.ai@, inboxapi.io@ ו-inboxapi.dev@ לא נספרים במגבלת 5 החריצים.
- כאשר כל 5 חריצי פנקס הכתובות החיצוניים מלאים, הערך שהיה הכי פחות בשימוש (LRU) מוחלף אוטומטית לאחר 5 ימים של חוסר פעילות.
פנקס כתובות (Addressbook)
פנקס הכתובות עוקב אחר כתובות האימייל החיצוניות שאליהן החשבון שלך שלח דואר. הוא מתמלא אוטומטית — אין שלב הגדרה ידני ואין דרך להוסיף או להסיר ערכים באופן ידני.
| התנהגות | פירוט |
|---|---|
| מילוי אוטומטי | כתובות חיצוניות חדשות מתווספות כאשר אתה שולח אימייל |
| מגבלת חריצים | 5 כתובות חיצוניות לכל חשבון |
| פינוי LRU | הערך שהיה הכי פחות בשימוש מוחלף אוטומטית לאחר 5 ימים של חוסר פעילות |
| כתובות פטורות | inboxapi.ai@, inboxapi.io@, inboxapi.dev@ — ללא הגבלה, לעולם לא נספרות |