יצירה וביטול של מפתח API

לפני יצירת מפתח#

מפתח API מאפשר למערכת חיצונית לגשת למידע ולפעולות שאישרתם בעסק. אפשר להפיק חשבוניות דרך ה־API כשהמפתח כולל את הרשאת ניהול מסמכים וטיוטות. הבקשה חייבת להתאים לסוג המסמך, להרשאות הנוספות של הפעולות הכלולות בה ולכללי העסק; מפתח לקריאת מסמכים בלבד אינו מאפשר הפקה. יצירת חשבונית מס אינה גובה כסף כשלעצמה. גישת API כלולה בכל החבילות, כולל Starter ותקופת הניסיון שלה; יצירת מפתח עדיין דורשת הרשאת משתמש מתאימה. Daily תומכת בקריאה ובכתיבה בפעולות הנתמכות, אבל מפתח אינו מעניק כתיבה לכל משאב: משתמשים רק במתודה, בנתיב ובהרשאה שמופיעים בממשק ובתיעוד הזמין לחיבור. הכינו שם ברור לחיבור ואת רשימת המידע והפעולות שהוא באמת צריך.

יצירת מפתח#

1. פתחו מפתחות API ולחצו יצירת מפתח חדש.
2. מלאו שם לחיבור ובחרו את ההרשאות הזמינות והנדרשות בלבד.
3. אשרו את היצירה והעתיקו את המפתח למקום המאובטח של המערכת המתחברת.
4. המפתח המלא מוצג פעם אחת בלבד. לאחר סגירת החלון אי אפשר להציגו שוב.
5. בדקו את החיבור לפי תיעוד המפתחים ואת המפתח ברשימת המפתחות.

ניהול וביטול#

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

תיעוד למפתחים#

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

אפשר ליצור טיוטת לקוח ממילוי קישור הרשמה או דרך הפעולה הציבורית POST /customer-drafts, בהרשאת customers:write ועם Idempotency-Key. מדריך טיוטת הלקוח מסביר את הבדיקה וההשלמה. POST /customers הוא מסלול נפרד שמקים לקוח ישירות. למידע על הקמת טיוטת לקוח, השלמת טיוטת הרשמה וההבדל מלקוח לא פעיל, ראו את המדריך המקושר.

אימות לפני פעולה רגישה#

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

פלטפורמה ועסקים מנוהלים#

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