📘 תיעוד 258

Postman

למדו איך להגדיר את Postman כדי לקיים אינטראקציה עם R2.

עודכן לאחרונה: 5 במאי 2026

Postman היא פלטפורמת API שמקלה על אינטראקציה עם ממשקי API. המדריך הזה יסביר איך להשתמש ב-Postman כדי לבצע בקשות R2 מאומתות, ליצור באקט, להעלות אובייקט חדש, ואז לאחזר את האובייקט. אוסף Postman ↗︎ של R2 כולל רשימה מלאה של הפעולות שהפלטפורמה תומכת בהן.

#1. רכישת R2

המדריך הזה מניח שיצרתם חשבון Cloudflare ורכשתם את R2.

#2. היכרות עם R2 ב-Postman

עיינו באוסף Postman ↗︎ הזמין לציבור של R2. האוסף מאורגן בתיקייה Buckets לפעולות ברמת הבאקט ובתיקייה Objects לפעולות ברמת האובייקט. פעולות בתיקייה Objects > Upload מאפשרות להוסיף אובייקטים חדשים ל-R2.

#3. הגדרת פרטי הגישה של R2

בלוח הבקרה של Postman ↗︎, בחרו את האוסף Cloudflare R2 ועברו ללשונית Variables. ב-Variables אפשר להגדיר משתנים בתוך אוסף R2. הם ישמשו לאימות ולאינטראקציה עם פלטפורמת R2. זכרו תמיד לבחור Save אחרי עדכון משתנה.

כדי לבצע פעולות בסיסיות, יש להגדיר את המשתנים account-id, r2-access-key-id ו-r2-secret-access-key בלוח הבקרה של Postman > Variables.

כדי לעשות זאת:

1. בלוח הבקרה של Cloudflare, עברו לעמוד R2 object storage. מעבר אל Overview ↗
2. ב-R2, תחת Manage R2 API Tokens בצד ימין של לוח הבקרה, העתיקו את מזהה חשבון Cloudflare שלכם.
3. חזרו אל לוח הבקרה של Postman ↗︎.
4. הגדירו את CURRENT VALUE של account-id למזהה חשבון Cloudflare שלכם ובחרו Save.

בשלב הבא, צרו אסימון API של R2:

1. בלוח הבקרה של Cloudflare, עברו לעמוד R2 object storage. מעבר אל Overview ↗
2. בסרגל הצד הימני, בחרו Manage R2 API Tokens.
3. בחרו Create API token.
4. תנו לאסימון את השם Postman על ידי בחירת סמל העיפרון ליד שם ה-API, והעניקו לו את ההרשאה Edit.

שמרו על האסימון הזה ועל Access Key ID ו-Secret Access Key בקפידה. לא תוכלו לראות את הערכים האלה שוב אחרי סיום השלב הזה. כל מי שיש לו את המידע הזה יכול לקיים אינטראקציה מלאה עם כל הבאקטים שלכם.

אחרי שיצרתם את אסימון ה-API בלוח הבקרה של Cloudflare:

1. עברו אל לוח הבקרה של Postman ↗︎ > Variables.
2. העתיקו את הערך Access Key ID מלוח הבקרה של Cloudflare והדביקו אותו בערך המשתנה r2-access-key-id של Postman, ובחרו Save.
3. העתיקו את הערך Secret Access Key מלוח הבקרה של Cloudflare והדביקו אותו בערך המשתנה r2-secret-access-key של Postman, ובחרו Save.

בשלב הזה אמורים להיות מוגדרים ב-Postman הערכים account-id, r2-secret-access-key ו-r2-access-key-id.

כדי לאמת את האסימון:

1. בלוח הבקרה של Postman, בחרו את חץ הרשימה הנפתחת של התיקייה Cloudflare R2 > חץ הרשימה הנפתחת של התיקייה Buckets > GETListBuckets.
2. בחרו Send.

אוסף Postman משתמש באימות AWS SigV4 כדי להשלים את לחיצת היד.

אמורה להופיע תשובה 200 OK עם רשימת הבאקטים הקיימים. אם מתקבלת שגיאה, ודאו שמנוי R2 פעיל ומשתני Postman נשמרו נכון.

#4. יצירת באקט

בלוח הבקרה של Postman:

1. עברו אל Variables.
2. הגדירו את ערך המשתנה r2-bucket כשם באקט R2 שלכם ובחרו Save.
3. בחרו את חץ הרשימה הנפתחת של התיקייה Cloudflare R2 > חץ הרשימה הנפתחת של התיקייה Buckets > PUTCreateBucket ובחרו Send.

אמורה להופיע תשובה 200 OK. אם תריצו שוב את הבקשה ListBuckets, הבאקט יופיע ברשימת התוצאות.

#5. הוספת אובייקט

עכשיו תוסיפו אובייקט לבאקט:

1. עברו אל Variables בלוח הבקרה של Postman.
2. הגדירו את r2-object ל-cat-pic.jpg ובחרו Save.
3. בחרו את חץ הרשימה הנפתחת של התיקייה Cloudflare R2 > חץ הרשימה הנפתחת של התיקייה Objects > חץ הרשימה הנפתחת של התיקייה Multipart > PUTPutObject ובחרו Send.
4. עברו אל Body ובחרו binary לפני צירוף תמונת החתול.
5. בחרו Send כדי להוסיף את תמונת החתול לבאקט R2.

אחרי כמה שניות אמורה להתקבל תשובה 200 OK.

#6. קבלת אובייקט

נדרשות עוד כמה לחיצות כדי להוריד את החבר החתולי שלנו באמצעות הבקשה GetObject.

1. בחרו את חץ הרשימה הנפתחת של התיקייה Cloudflare R2 > חץ הרשימה הנפתחת של התיקייה Objects > GETGetObject.
2. בחרו Send.

צוות R2 ימשיך לעדכן את האוסף הזה ככל שנרחיב את מערך התכונות של R2. אפשר להמשיך ולחקור את שאר אוסף Postman של R2 על ידי ניסוי בפעולות אחרות.