📘 תיעוד 10

יצירת אסימון API

עודכן לאחרונה: 20 באפריל 2026 | העתקה כ-Markdown | הצגה כ-Markdown | הגדרת סוכן

למדו איך ליצור אסימון לביצוע פעולות באמצעות ה-API של Cloudflare.

דרישת קדם

לפני שמתחילים, מצאו את מזהי האזור והחשבון.

1. קבעו אם אתם רוצים אסימון משתמש או אסימון API של חשבון. השתמשו באסימוני API של חשבון אם אתם מעדיפים אסימוני שירות שאינם משויכים למשתמשים ונקודות הקצה הרצויות של ה-API תואמות.
2. מתוך לוח הבקרה של Cloudflare ↗︎, עברו אל My Profile > API Tokens עבור אסימוני משתמש. עבור Account Tokens, עברו אל Manage Account > API Tokens.
3. בחרו Create Token.
4. בחרו תבנית מתוך תבניות אסימון ה-API הזמינות, או צרו אסימון מותאם אישית. הדוגמה הבאה משתמשת בתבנית Edit zone DNS.
5. הוסיפו או ערכו את שם האסימון כך שיתאר למה או איך האסימון משמש. התבניות ממולאות מראש בשם אסימון ובהרשאות.
6. שנו את הרשאות האסימון. אחרי בחירת קבוצת הרשאות (Account, User או Zone), בחרו איזו רמת גישה להעניק לאסימון. רוב הקבוצות מציעות את האפשרויות Edit או Read. Edit הוא גישת CRUDL מלאה (create, read, update, delete, list), בעוד Read הוא הרשאת קריאה ו-list במקום המתאים. עיינו בהרשאות האסימון הזמינות למידע נוסף.
7. בחרו לאילו משאבים האסימון מורשה לגשת. לדוגמה, הענקת גישת Zone DNS Read לאזור example.com תאפשר לאסימון לקרוא רשומות DNS רק עבור האזור הספציפי הזה. כל אזור אחר יחזיר שגיאה בפעולות קריאה של רשומות DNS. גם כל פעולה אחרת על האזור הזה תחזיר שגיאה.
8. (אופציונלי) הגבילו את אופן השימוש באסימון בשדות Client IP Address Filtering ו-TTL (time to live).
9. בחרו Continue to summary.
10. עיינו בסיכום האסימון. בחרו Edit token כדי לבצע התאמות. אפשר גם לערוך אסימון אחרי היצירה.

11. בחרו Create Token כדי ליצור את סוד האסימון.
12. העתיקו את הסוד למקום מאובטח.

אזהרה

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

דף סוד האסימון כולל גם פקודת דוגמה לבדיקת האסימון. השתמשו בנקודת הקצה /user/tokens/verify כדי לקבל את המצב הנוכחי של האסימון הנתון.

curl "https://api.cloudflare.com/client/v4/user/tokens/verify" \
--header "Authorization: Bearer <API_TOKEN>"

התוצאה:

{
	"result": {
		"id": "100bf38cc8393103870917dd535e0628",
		"status": "active"
	},
	"success": true,
	"errors": [],
	"messages": [
		{
			"code": 10000,
			"message": "This API Token is valid and active",
			"type": null
		}
	]
}

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

בכך יצרתם בהצלחה אסימון API ואפשר להתחיל לעבוד עם ה-API של Cloudflare. אחרי יצירת אסימון ה-API הראשון, אפשר ליצור אסימוני API נוספים באמצעות ה-API.