כך מגדירים את המפתח בכותרת הבקשה (זה יכול להשתנות לפי שפת התכנות): --header 'Authorization: api token' \
כדי ליצור מפתח API, לחצו על אינטגרציות ← מפתחות API ← חדש.
-
שם (חובה): שם למפתח. בחרו שם שמתאר למה המפתח משמש. לדוגמה, אם אתם מחברים את Salesforce דרך האינטגרציה של אקטיב טרייל, קראו למפתח "Salesforce".
-
תיאור (לא חובה) - תיאור של מטרת המפתח.
-
כתובות IP מורשות (לא חובה) - כתובות ה-IP שמהן מותר לבצע קריאות. קריאה מכל כתובת IP אחרת תקבל שגיאה 401.
-
תאריך פקיעת תוקף (לא חובה) - המועד שבו המפתח יפסיק לעבוד.
שימו לב: אחרי השמירה המפתח מוצג פעם אחת בלבד (!), ומטעמי אבטחת מידע לא תוכלו לראות אותו שוב.
מומלץ לשמור את המפתח בקובץ מוצפן, ולא לשלוח אותו בערוצים לא מוצפנים כמו מייל.
אפשר להשתמש בפרוטוקול אבטחה שונה מברירת המחדל של אקטיב טרייל (TLS 1.2), כל עוד המערכת שלכם משתמשת בו. אם ההצפנה מופעלת והבקשות שלכם לא משתמשות בה, תקבלו שגיאה 401.