ขอ API แรกของคุณในแอพคำสั่งลัด
ในการขอ API แรกของคุณ คุณต้องสร้าง URL ที่ชี้ไปยัง “ตำแหน่งข้อมูล” ของ API ที่คุณต้องการสื่อสารด้วย จากนั้นให้ส่งผ่าน URL นั้นไปยังการกระทำรับเนื้อหาของ URL เมื่อมีการสั่งทำงานคำสั่งลัด การกระทำนี้จะสร้างคำขอ API
สร้างคำขอ API
ตำแหน่งข้อมูลพยากรณ์ของ Dark Sky ต้องใช้คำขอ URL ที่จัดรูปแบบดังนี้:
https://api.darksky.net/forecast/[YOUR_SECRET_KEY]/[LAT],[LONG]
ข้อความในวงเล็บเหลี่ยมจะถูกป้อนด้วยคีย์ API และตำแหน่งที่ตั้งที่คุณต้องการข้อมูลพยากรณ์
ในแอพคำสั่งลัด ให้วางคีย์ API ของคุณจาก Dark Sky ลงในการกระทำข้อความแรก ซึ่งจะถูกส่งผ่านไปยังการกระทำ URL ในรูปตัวแปร ค่า
LAT
และLONG
ถูกตั้งค่าเป็น37.8267
และ-122.4233
ไว้อยู่แล้ว ซึ่งเป็นจุดพิกัดสำหรับเกาะอัลคาทราซในซานฟรานซิสโก (คุณสามารถเปลี่ยนค่าเหล่านั้นไปยังตำแหน่งที่ตั้งอื่นได้)ลองใช้การกระทำรับตำแหน่งที่ตั้งปัจจุบันและวางเป็นตัวแปร Magic ที่ตั้งค่าละติจูดและลองจิจูดตามการกระทำ URL เพื่อรับข้อมูลสภาพอากาศในพื้นที่เมื่อใดก็ตามที่คุณสั่งทำงานคำสั่งลัด
ดำเนินการขอ API ด้วยการกระทำรับเนื้อหาของ URL
ในตัวแก้ไขคำสั่งลัดของแอพคำสั่งลัด ให้ตั้งค่า รับเนื้อหาของ URL เป็นขั้นสูง
ตัวเลือกประเภทคำขอ API ที่คุณสามารถสร้างได้มีดังต่อไปนี้:
GET
อนุญาตให้คุณดึงข้อมูลจาก API เพื่ออ่านPOST
อนุญาตให้คุณสร้างข้อมูลใหม่PUT
และPATCH
อนุญาตให้คุณอัพเดทข้อมูลโดยการแทนที่หรือแก้ไขข้อมูล ตามลำดับDELETE
อนุญาตให้คุณเอาวัตถุที่ระบุในคำขอ URL ออก
สำหรับตัวอย่างนี้ ให้ใช้คำขอ
GET
เพื่อดึงข้อมูลจาก API ของ Dark Skyเมื่อการกระทำ URL มีคำขอของคุณและการกระทำรับเนื้อหาของ URL ถูกตั้งค่าเป็น
GET
แล้ว คุณก็พร้อมที่จะสร้างคำขอ API ได้เลยหมายเหตุ: เมื่อเปลี่ยนการกระทำรับเนื้อหาของ URL เป็น
POST
,PUT
หรือPATCH
พารามิเตอร์ตัวใหม่ที่เรียกว่า ขอเนื้อหา จะถูกเพิ่มเข้ามา ขอเนื้อหาอนุญาตให้คุณส่ง JSON, แบบฟอร์ม หรือ ไฟล์ เป็นส่วนหนึ่งของคำขอไปยัง API วิธีนี้ทำให้คุณสามารถป้อนข้อมูลใหม่ด้วยตนเองหรือโดยใช้ตัวแปรได้ คุณจึงสามารถส่งข้อมูลไปยัง API เพื่อสร้าง แทนที่ หรือแก้ไขรายการได้แตะ เพื่อทดสอบคำสั่งลัด (การกระทำดูแบบรวดเร็วในคำสั่งลัดช่วยให้คุณดูตัวอย่างข้อมูลที่ API ส่งกลับได้)
ยินดีด้วย คุณได้สร้างคำขอ API แรกของคุณโดยใช้แอพคำสั่งลัดแล้ว
ครั้งแรกที่เห็นนั้น API ดูเหมือนจะส่งข้อความที่จัดรูปแบบแปลกๆ กลับมาในปริมาณมาก เมื่อตรวจสอบใกล้ๆ จะเห็นว่าข้อความนั้นมีข้อมูลพยากรณ์อากาศ ข้อมูลสภาพอากาศนี้ถูกเข้ารหัสเป็น JSON ซึ่งย่อมาจาก JavaScript Object Notation
ในการเรียนรู้เรื่องการทำงานกับ JSON และดำเนินการต่อกับตัวอย่าง API ของ Dark Sky โปรดดู เกี่ยวกับการใช้ JSON ในแอพคำสั่งลัด