ประเด็นความรู้หลักเหล่านี้ต้องได้รับการเรียนรู้ในการสื่อสารส่วนหน้าและส่วนหลัง!

สงบสุขคืออะไร?

Restful เป็นข้อกำหนดการออกแบบอินเทอร์เฟซที่ได้รับความนิยมมากที่สุดในขณะนี้ เป็นข้อกำหนดที่ทั้งส่วนหน้าและส่วนหลังต้องทราบ ข้อกำหนดนี้กำหนดว่าในการพัฒนาอินเทอร์เฟซ ในแต่ละกระบวนการ

โปรโตคอล

ควรใช้เมื่อสื่อสารกับส่วนหลัง - สิ้นสุดบริการผ่าน API

ชื่อโดเมน

ควรใช้งานภายใต้ชื่อโดเมนเฉพาะและควรเรียบง่ายที่สุด หากคุณแน่ใจว่า API นั้นเรียบง่ายมากและจะไม่ถูกขยายเพิ่มเติม คุณสามารถพิจารณาวางไว้ใต้ชื่อโดเมนหลักได้ ต่อไปนี้คือตัวอย่างรากของ URL ทั่วไปสองตัวอย่าง:

• api.example.com/* มีการใช้ชื่อโดเมนย่อยที่แยกต่างหาก เข้าถึงอินเทอร์เฟซ
• example.com/api /* API ทั้งหมดในเวอร์ชันพื้นที่เดียว

(เวอร์ชัน)

จะต้องยังคงเข้ากันได้แบบย้อนหลัง คุณต้องแนะนำ API เวอร์ชันใหม่ในขณะที่ตรวจสอบให้แน่ใจว่า API เวอร์ชันเก่ายังคงมีอยู่ ดังนั้น

ควรระบุที่อยู่สนับสนุนเวอร์ชัน (เส้นทาง) สำหรับ URL เฉพาะของ

API

• การตั้งชื่อ URL จะต้องเป็นตัวพิมพ์เล็กทั้งหมด
• การตั้งชื่อทรัพยากร (ทรัพยากร) ใน URL จะต้องเป็นคำนาม และต้องอยู่ในรูปพหูพจน์
• ต้องใช้ URL ประเภท Restful ก่อน
• ต้องเป็น URL ที่อ่านง่าย
• และต้องไม่เปิดเผยสถาปัตยกรรม

เซิร์ฟเวอร์ ไม่มีกฎที่ยากและรวดเร็ว แต่จะต้องสอดคล้องกับสไตล์ตามสถานการณ์ของทีม

• https://api.example com/zoos
• https://api.example.com/animals
• https://api.example .com/zoos/{zoo}/animals
• https://api.example.com/animal_types
• https://api.example

กริยา com/employees (วิธีการร้องขอ)

เป็นประเภทการดำเนินการเฉพาะสำหรับทรัพยากร ซึ่งแสดงด้วยกริยา HTTP . มีคำกริยา HTTP ที่ใช้กันทั่วไปอยู่ห้าคำ (คำสั่ง SQL ที่เกี่ยวข้องจะอยู่ในวงเล็บ)

• GET (SELECT): ดึงทรัพยากร (หนึ่งรายการขึ้นไป) จากเซิร์ฟเวอร์
• โพสต์ (สร้าง): สร้างทรัพยากรใหม่บนเซิร์ฟเวอร์
• PUT (UPDATE): อัปเดตทรัพยากรบนเซิร์ฟเวอร์ (ไคลเอนต์จัดเตรียมทรัพยากรที่สมบูรณ์หลังการเปลี่ยนแปลง)
• PATCH (UPDATE): อัปเดตในส่วนทรัพยากรการอัปเดตเซิร์ฟเวอร์ (ไคลเอนต์ให้แอตทริบิวต์ที่เปลี่ยนแปลง)
• ลบ (ลบ): ลบทรัพยากรออกจากเซิร์ฟเวอร์

พารามิเตอร์ url

พารามิเตอร์ URL ทั้งหมดจะต้องเป็นตัวพิมพ์เล็กทั้งหมดและต้องใช้รูปแบบพารามิเตอร์ประเภทขีดล่าง พารามิเตอร์การเพจต้องได้รับการแก้ไขเป็น page และ page_size

การตอบสนอง (การตอบสนอง)

จะต้องเลือกรหัสสถานะ HTTP ที่เหมาะสม
ข้อมูลจะต้องส่งคืนในรูปแบบ JSON
ข้อผิดพลาดทั้งหมดจะต้องมีรูปแบบที่เหมือนกัน

รหัสสถานะทั่วไป

• 1xx หมายความว่าคำขอได้รับการยอมรับแล้วและจำเป็นต้องดำเนินการต่อไป
• โดยทั่วไป 2xx จะไม่ปรากฏใน API และส่วนหัวการตอบกลับหรือเนื้อหาข้อมูลที่คาดหวังจากคำขอจะถูกส่งกลับพร้อมกับการตอบกลับนี้
  • 200. เซิร์ฟเวอร์ส่งคืนข้อมูลที่ร้องขอโดยผู้ใช้สำเร็จ
  • 201 ผู้ใช้สร้างข้อมูลใหม่หรือแก้ไขข้อมูลสำเร็จ
  • 202 หมายความว่าคำขอได้เข้าสู่คิวเบื้องหลัง (ไม่มีค่าส่งคืนหากสำเร็จจะเป็นแบบอะซิงโครนัส)
  • 204 ลบสำเร็จ
• 3xx
ข้อผิดพลาด 4xx
• ในการเปลี่ยนเส้นทาง
• เกิดจากสาเหตุของไคลเอ็นต์
  • 404 ไม่มีอินเทอร์เฟซที่ร้องขอ ประเภทข้อผิดพลาด (ที่อยู่คำขอไม่ถูกต้อง)
  • 401 ผู้ใช้ไม่ได้
  • เข้าสู่ระบบ 403 ผู้ใช้เข้าสู่ระบบ แต่ไม่ได้รับอนุญาตให้เข้าถึง
  • 422 ข้อผิดพลาดพารามิเตอร์ไคลเอ็นต์ ข้อผิดพลาดในการตรวจสอบ
  • 429 เกินขีดจำกัดคำขอ
• 5xx ข้อผิดพลาดที่เกิดจากเหตุผลฝั่งเซิร์ฟเวอร์
  • 500 เซิร์ฟเวอร์พบสถานการณ์ที่ไม่คาดคิด ซึ่งทำให้ไม่สามารถดำเนินการตามคำขอได้สำเร็จ รหัสเซิร์ฟเวอร์รายงาน
  • ข้อผิดพลาด 503 เซิร์ฟเวอร์อยู่ระหว่างการบำรุงรักษา
  • 504 หมดเวลา

รูปแบบข้อผิดพลาด

• • ในการโทร

'ข้อความ' => ': ข้อความ', // คำอธิบายโดยละเอียดของข้อผิดพลาด 'ข้อผิดพลาด' => ': ข้อผิดพลาด', // คำอธิบายข้อผิดพลาดโดยละเอียดของพารามิเตอร์ 422 และสถานะอื่น ๆ ให้ 'รหัส' => ' :code', // รหัสข้อยกเว้นที่กำหนดโดยธุรกิจ 'status_code' => ':status_code', // รหัสสถานะ http 'debug' => ':debug', // ข้อมูลการดีบัก, สภาพแวดล้อมที่ไม่ใช้งานจริงระบุว่า

ข้อความคืออะไร ?

ข้อความ HTTP ใช้เพื่อแลกเปลี่ยนข้อมูลเมื่อมีการร้องขอและการตอบกลับของ HTTP ข้อความที่ส่งไปยังเซิร์ฟเวอร์จากไคลเอนต์

แบ่งออกเป็นสองประเภท: ข้อความคำขอ

และข้อความตอบกลับ โครงสร้างข้อความพื้นฐานของข้อความคำขอและข้อความตอบกลับจะเหมือนกัน และประกอบด้วยสามส่วน:

• เส้นเริ่มต้น: ดำเนินการประมวลผลบน ข้อความ คำอธิบาย
• ส่วนหัว: คุณลักษณะบางอย่าง
• เนื้อความ: ข้อมูล [ทางเลือก]

axios

และเซิร์ฟเวอร์โหนดสร้าง XMLHttpRequests จากเบราว์เซอร์
การสร้างคำขอ http จาก node.js

รองรับ Promise API
รองรับการสกัดกั้นคำขอและการตอบกลับ การแปลงข้อมูลคำขอและข้อมูลการตอบกลับ การยกเลิกคำขอ การแปลง JSON อัตโนมัติ การสนับสนุนไคลเอ็นต์ข้อมูลเพื่อป้องกัน XSRF

มาเลย คนแปลกหน้า (ฉันไม่ใช่คนแปลกหน้าในการมาและไป ฉันหวังว่าอย่างนั้น จะเป็นประโยชน์กับคุณ)

ข้างต้นคือประเด็นความรู้หลักที่ต้องเชี่ยวชาญด้านการสื่อสารส่วนหน้าและส่วนหลัง! สำหรับรายละเอียดเพิ่มเติม โปรดอ่านบทความอื่นๆ ที่เกี่ยวข้องบนเว็บไซต์ php Chinese!