בקשת ה-API הראשונה שלך ב״קיצורים״
על-מנת לבקש את ה-API הראשון שלך, יש ליצור כתובת אינטרנט המצביעה על ״נקודת הקצה״ של ה-של API שברצונך לדבר עמו, ולאחר מכן להעביר כתובת זו לפעולה ״קבל תוכן של כתובת אינטרנט״. בעת פעולת הקיצור, פעולה זו תבצע את בקשת ה-API.
בניית בקשת ה-API
נקודת הקצה של תחזית Dark Sky דורשת כי בקשת כתובת אינטרנט תהיה במבנה הבא:
https://api.darksky.net/forecast/[הקוד_הסודי_שלך]/[רוחב],[אורך]
המלל בסוגריים ימולא בקוד API ובמיקום שלגביו תרצה/י נתוני תחזית.
ביישום ״קיצורים״, מקם/י את קוד ה-API מה-Dark Sky בפעולת ה״מלל״ הראשונה, המועברת אל הפעולה ״כתובת אינטרנט״ כמשתנה. הערכים
LATו-LONGמוגדרים כבר ל-37.8267ול-122.4233-, הקואורדינטות לאי אלקטרז בסן-פרנסיסקו. (ניתן לשנות את הערכים האלה למיקום אחר.)נסה/י להשתמש בפעולה ״קבל מיקום נוכחי״ ולמקמה כש״משתנה קסם״ מוגדר ל״קו רוחב״ ו״קו אורך״ בפעולת כתובת האינטרנט על-מנת לקבל נתוני מזג אוויר מקומי בכל הפעלה של הקיצור.
ביצוע בקשת ה-API באמצעות הפעולה ״קבל תוכן של כתובת אינטרנט״
בעורך הקיצורים ביישום ״קיצורים״, הגדר/י את ״קבל תוכן של כתובת אינטרנט״ כ״מתקדם״.
האפשרויות הבאות עבור סוגי בקשות ה-API שביכולתך לבצע הופכות לזמינות:
GETמאפשרת לך לאחזר נתונים לקריאה מ-API.
POSTמאפשרת לך ליצור נתונים חדשים.
PUTו-PATCHמאפשרות לך לעדכן נתונים על-ידי החלפה או שינוי שלהם, בהתאמה.
DELETEמאפשרת לך להסיר אובייקט שצוין בבקשת ה-URL.
עבור דוגמה זו, השתמש/י בבקשת
GETלאחזור נתונים מה-API של Dark Sky.כעת כשפעולת כתובת האינטרנט קיבלה את בקשתך והפעולה ״קבל תוכן של כתובת אינטרנט״ מוגדרת לנתוני
GET, הינך מוכן/ה לבצע בקשת API.הערה: כשהפעולה ״קבל תוכן של כתובת אינטרנט״ עוברת ל-
POST,PUTאוPATCH, מתווסף פרמטר חדש בשם ״גוף בקשה״. ״גוף בקשה״ מאפשר לך לשלוח JSON, טופס או קובץ ל-API כחלק מבקשתך. פעולה זו מאפשרת לך להכניס נתונים חדשים באופן ידני או על-ידי שימוש במשתנים כך שניתן לשלוח את הנתונים ל-API ליצירה, להחלפה או לשינוי של רשומה.הקש/י על
על-מנת לבדוק את הקיצור (הפעולה ״הצצה מהירה״ בקיצור מאפשרת לך להציג בתצוגה מקדימה את הנתונים המוחזרים על-ידי ה-API).
מזל טוב, סיימת לבצע את בקשת ה-API הראשונה שלך באמצעות ״קיצורים״.
במבט ראשון, נראה כי ה-API מחזיר הרבה מלל במבנה מוזר. ואולם, מבחינה מדוקדקת יותר עולה כי מלל זה מכיל פרטי תחזית מזג אוויר. נתוני מזג אוויר אלה מקודדים ב-JSON, ראשי תיבות של JavaScript Object Notation.
על-מנת לקבל מידע נוסף בנושא עבודה עם JSON ולהמשיך עם דוגמת ה-API של Dark Sky, ראה/י אודות שימוש בקובץ JSON ב״קיצורים״.