סקירת TrekMail Drive API למפתחים

TrekMail Drive API מאפשר ליישומים מהימנים ולסוכני AI לעבוד עם אותו אחסון קבצים שמופיע בלוח הבקרה ובדואר האינטרנט. השתמשו בו כדי להציג תיקיות, להעלות קבצים, ליצור קישורי הורדה ציבוריים, לשחזר פריטים מהאשפה, לבדוק את השימוש באחסון ולהפוך תהליכי קבצים חוזרים לאוטומטיים בלי לתת לסוכן גישה לכל החשבון.

האוטומציה של Drive היא חלק מ-TrekMail REST API v1. היא משתמשת באסימוני bearer, בתגובות JSON, בהגנת אידמפוטנטיות כאשר ה-endpoint תומך בה ובאותו נתיב ביקורת שמופיע תחת סוכני AI ו-API ← יומן ביקורת. מודל ההרשאות של Drive כולל 11 היקפים, ובהם היקפים נפרדים לסיסמאות של מכשירי סנכרון. הקטלוגים של endpoints וכלי MCP משתנים, לכן השתמשו ברשימת הכלים שמוחזרת ובתגובות ה-API כדי לראות את הממשק הזמין כעת לאסימון שלכם.

מה אפשר להפוך לאוטומטי

משימות אופייניות של Drive API כוללות:

• העלאת דוחות חודשיים אל Drive של החשבון.
• יצירת תיקיית לקוח, הוספת קבצים ושיתוף קישור הורדה אחד.
• מתן אפשרות לסוכן לחפש במרחבי Drive של תיבות דואר ולסכם מה השתנה.
• העברת קבצים ישנים לתיקיית ארכיון.
• שחזור קבצים מהאשפה לאחר ניקוי שבוצע בטעות.
• קריאת מצב תוסף Drive לפני שמזהירים משתמש שהאחסון כמעט מלא.

ה-API מתמקד בקבצים במכוון. הוא אינו מחליף את לוח הבקרה לחיוב ואינו חושף שינויים בתשלומים או במינויים.

Drive של החשבון ו-Drive של תיבת הדואר

ל-Drive יש שני משטחי אחסון. Drive של החשבון הוא המרחב המשותף של החברה. בדרך כלל זה המקום המתאים לנכסי מותג, חוזים, חומרי קליטה ותיקיות צוות. Drive של תיבת הדואר הוא אחסון אישי שמחובר לתיבת דואר בתוך דואר האינטרנט.

בקשות API מזהות את היעד באמצעות הפרמטר space:

account       # Account Drive
mailbox:42    # mailbox-personal Drive for mailbox ID 42
123           # internal Drive space ID, if your integration stores it

אפשר להגביל אסימונים לתיבות דואר מסוימות. אם אסימון מוגבל לתיבה 42, בקשות לתיבה 99 מחזירות תגובה בסגנון "לא נמצא" במקום לחשוף שתיבת הדואר האחרת קיימת.

אימות וכתובת URL בסיסית

השתמשו באסימון תפעול בכותרת Authorization:

Authorization: Bearer tm_live_your_token

ה-endpoints של Drive נמצאים תחת:

https://trekmail.net/api/v1/drive

צרו אסימונים מתוך סוכני AI ו-API ← אסימונים. בחרו רק את היקפי Drive שתהליך העבודה דורש.

אחד עשר היקפי Drive

העלאות וקבצים גדולים

העלאות משתמשות בתבנית של שני שלבים. תחילה ה-API שומר מכסה ומחזיר הוראות העלאה. לאחר מכן הלקוח שולח את הבתים של הקובץ לכתובת ההעלאה. לבסוף ה-API מסמן שההעלאה הושלמה. קבצים גדולים יכולים להשתמש בהעלאה מרובת חלקים ולרענן את כתובות החלקים אם העברה ארוכה פגה.

לרוב סוכני ה-AI, כלי MCP בשם drive_file_upload פשוט יותר מקריאה ישירה ל-endpoints ברמה נמוכה. הוא מטפל בזיהוי גודל הקובץ, בהעלאה, בהשלמה ובביטול במקרה של כשל בפקודה אחת.

קישורי שיתוף

קישורי שיתוף יוצרים כתובות URL ציבוריות להורדה של קבצים בודדים. הם שימושיים כאשר קובץ גדול מדי לדוא"ל או כאשר צריך שיהיה אפשר לבטל את הגישה. הגדירו תאריך תפוגה ומגבלת הורדות בכל מקום שאפשר. האסימון הגולמי של הקישור מוחזר פעם אחת בלבד, בזמן היצירה, לכן שמרו מיד את הכתובת שהוחזרה אם תהליך העבודה זקוק לה.

בטיחות במחיקה ובמחיקה לצמיתות

פעולות מחיקה רגילות מעבירות קבצים ותיקיות לאשפה. הפריטים נשארים ניתנים לשחזור עד שהם משוחזרים, נמחקים לצמיתות או מוסרים לפי כללי השמירה של המוצר. פעולות מחיקה לצמיתות דורשות היקפים מתאימים ויש לבודד אותן באסימון נפרד.

גבול תוסף Drive

סוכנים יכולים לקרוא את מצב תוסף Drive, המחיר והתצוגה המקדימה של ביטול באמצעות drive:addon:read. קנייה, שינוי נפח או ביטול של תוסף Drive אינם זמינים דרך כלי כתיבה של REST או MCP. פעולות אלה נשארות בלוח הבקרה כדי שחיוב האחסון יישאר תהליך מכוון בשליטת המשתמש.