איך הגישה עובדת
הגישה ניתנת לפרויקט ולא לאדם: לפרויקט יש בעלים (חשבון iBus), קבוצות פעולות, מפתחות, כתובות IP לפי הצורך ומגבלות.
1. בקשה
התחברו ל-iBus ותארו את הפרויקט: מה אתם בונים, אילו נתונים צריך, העומס הצפוי, איך ומאילו כתובות תפנו ל-API. כתובת הדוא״ל של החשבון הופכת לאיש הקשר המאומת.
בקשה פתוחה אחת בכל פעם; הטיוטה נשמרת בזמן הכתיבה.
2. בדיקה
צוות iBus קורא כל בקשה ועשוי לשאול שאלה. עונים בדף הבקשה, שבו מופיע גם הסטטוס: טיוטה, נשלחה, בבדיקה, נדרשים פרטים, אושרה או נדחתה.
לפני האישור אין מפתח, ואין התחייבות לזמן בדיקה.
3. פרויקט ומפתחות
- אחרי האישור הפרויקט מופיע באזור המפתחים עם הקבוצות והמגבלות שלו.
- שם יוצרים מפתח. הוא מוצג פעם אחת; iBus שומר רק גיבוב וקידומת קצרה, למשל
ibk_live_k_7mq2xw4hzt. - עד 5 מפתחות פעילים לפרויקט, ל-
testול-live. בהחלפת מפתח הישן ממשיך לעבוד עד 24 שעות. - מפתח שדלף מבטלים בלחיצה אחת, והוא מפסיק לעבוד תוך שניות.
4. כתובות IP
עם רשימת כתובות, בקשה צריכה גם מפתח נכון וגם כתובת מורשית. כשההגבלה פעילה והרשימה ריקה, כל בקשה נדחית. רשתות פרטיות ורחבות מדי אינן מתקבלות; רשת רחבה דורשת אישור מפורש.
אם צוות iBus הגדיר את ההגבלה, שינויים עוברים דרך בקשה בדף הפרויקט.
5. מגבלות
| מי | בדקה (פרץ) | ביממה, UTC | בחודש, UTC | בו-זמנית | כבדות: בדקה / ביממה |
|---|---|---|---|---|---|
| פרויקט, «ניסיון» | 30 (10) | 1,000 | 20,000 | 2 | — |
| פרויקט, «רגיל» | 120 (30) | 20,000 | 400,000 | 4 | — |
| פרויקט, מותאם (דוגמה) | 120 (30) | 20,000 | 400,000 | 4 | 6 / 300 |
| בלי מפתח: רק הכתובות הישנות, לכתובת (תקופת מעבר) | 60 (30) | 20,000 | 400,000 | 6 | 20 / 600 |
התקציב היומי והחודשי מתחדשים ב-00:00 UTC (02:00 או 03:00 בישראל, לפי העונה). דחייה מציינת איזו מגבלה הושגה ומתי לנסות שוב (Retry-After). מגבלות מותאמות נקבעות על ידי iBus לפי בקשה.
6. השהיה וחסימה
iBus יכול להשהות פרויקט (המפתחות נשמרים) או לחסום אותו (כל המפתחות מבוטלים), תמיד עם סיבה שמופיעה בדף הפרויקט, ושם אפשר להשיב. הפרות חוזרות, למשל מפתחות שגויים רבים, מובילות להשהיה אוטומטית קצרה; חסימה ארוכה היא רק החלטה של אדם.
7. מה נשמר
- על כל בקשה: הזמן, הפרויקט, קידומת המפתח, הפעולה, הסטטוס, משך הזמן והחלק הרשתי של הכתובת. פירוט נשמר 7 ימים, ואחר כך רק ספירות.
- כתובות מלאות עם פרמטרים וקואורדינטות מהבקשות שלכם אינן נשמרות.
- מפתחות אינם מופיעים ביומנים, בדוחות או בהודעות.
כל קודי הדחייה ומה לעשות: שגיאות גישה.