Mata pengetahuan teras ini mesti dikuasai dalam komunikasi hadapan dan belakang!

Apakah yang menenangkan?

Rehat ialah spesifikasi reka bentuk antara muka yang paling popular pada masa ini, spesifikasi yang mesti diketahui oleh kedua-dua bahagian hadapan dan bahagian belakang
Spesifikasi ini mentakrifkan pelbagai proses dalam pembangunan antara muka

Protokol

Dalam proses berkomunikasi dengan perkhidmatan back-end melalui API, pelanggan harus menggunakan protokol HTTPS

Nama domain

API harus Deployment di bawah nama domain khusus hendaklah disimpan semudah mungkin. Jika anda pasti bahawa API adalah sangat mudah dan tidak akan dikembangkan lagi, anda boleh mempertimbangkan untuk meletakkannya di bawah nama domain utama Berikut ialah dua contoh akar URL biasa:

• api.example.com. /* Nama subdomain tunggal Digunakan untuk mengakses antara muka
• example.com/api/* Ruang berasingan di bawah nama domain utama

Versi)

Semua API mesti kekal serasi ke belakang Anda mesti memperkenalkan versi baharu API sambil memastikan versi lama API masih tersedia. Oleh itu, sokongan versi harus disediakan untuknya

Alamat (laluan) Penghala (penghala)

URL khusus API

• Penamaan URL mestilah Semua huruf kecil
• Nama sumber dalam URL mestilah kata nama dan mesti dalam bentuk jamak
• URL jenis tenang mesti digunakan dahulu
• URL mesti boleh dibaca
• URL tidak boleh mendedahkan seni bina pelayan

Bagi sama ada URL mesti menggunakan tanda sempang (-) atau garis bawah (_), tidak ada yang keras dan pantas peraturan, tetapi ia mesti disatukan mengikut situasi pasukan

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

Kata kerja (kaedah kaedah permintaan)

Untuk jenis operasi khusus sumber, ia diwakili oleh HTTP kata kerja. Terdapat lima kata kerja HTTP yang biasa digunakan (arahan SQL yang sepadan ada dalam kurungan).

• DAPATKAN (PILIH): Dapatkan sumber (satu atau lebih item) daripada pelayan.
• POST (BUAT): Cipta sumber baharu pada pelayan.
• PUT (KEMASKINI): Kemas kini sumber pada pelayan (pelanggan menyediakan sumber diubah lengkap) dan kemas kini sepenuhnya.
• PATCH (KEMASKINI): Kemas kini dalam bahagian sumber kemas kini pelayan (pelanggan menyediakan atribut yang diubah).
• DELETE (DELETE): Padamkan sumber daripada pelayan.

parameter url

Semua parameter URL mestilah dalam semua huruf kecil dan mesti menggunakan borang parameter jenis garis bawah
Parameter halaman mesti ditetapkan pada halaman, page_size

Respons

Anda mesti memilih kod status HTTP yang sesuai.
Mesti mengembalikan data format JSON.
Semua ralat mestilah dalam format ralat yang sama.

Kod status biasa

• 1xx bermakna permintaan telah diterima dan perlu meneruskan pemprosesan Secara amnya, ia tidak muncul dalam API >
2xx Permintaan telah berjaya , pengepala respons atau badan data yang dijangkakan oleh permintaan akan dikembalikan dengan respons ini
• 200 Pelayan berjaya mengembalikan data yang diminta oleh pengguna
  • 201 Pengguna berjaya mencipta atau mengubah suai data
  • 202 bermakna Permintaan telah beratur di latar belakang (tiada nilai pulangan jika berjaya, ia adalah tak segerak)
  • 204 Berjaya padam
  3xx Redirect
• 4xx Client Disebabkan oleh ralat
• 404 Antara muka yang diminta tidak wujud, jenis ralat (alamat permintaan salah)
  • 401 Pengguna tidak log masuk
  • 403 Pengguna log masuk, tetapi tidak mempunyai kebenaran untuk mengakses
  • 422 Ralat parameter pelanggan, ralat pengesahan
  • 429 Had permintaan melebihi
  Ralat 5xx disebabkan oleh sebab sebelah pelayan
• 500 Pelayan menghadapi situasi yang tidak dijangka, yang menyebabkan ia tidak dapat menyelesaikan pemprosesan permintaan kod pelayan melaporkan ralat
  • 503 Server dalam penyelenggaraan
  • Panggilan tamat masa 504

Format salah

'message' => ':message',          // 错误的具体描述
'errors' => ':errors',            // 参数的具体错误描述，422 等状态提供
'code' => ':code',                // 业务自定义的异常码
'status_code' => ':status_code',  // http状态码
'debug' => ':debug',              // debug 信息，非生产环境提供

Apakah mesej itu?

Mesej HTTP digunakan untuk bertukar maklumat apabila HTTP meminta dan membalas. Mesej mengalir ke pelayan daripada pelanggan

Mesej dibahagikan kepada dua kategori: mesej permintaan dan mesej respons

Struktur mesej asas mesej permintaan dan respons adalah sama, dan terdiri. daripada Terdiri daripada tiga bahagian:

Baris permulaan: Huraikan mesej

• Tajuk: Beberapa atribut
• Badan: Data [pilihan]

axios

Serasi dengan penyemak imbas dan pelayan nod

Cipta XMLHttpRequests daripada penyemak imbas

Cipta permintaan http daripada node.js

API Janji Sokongan

Menyokong pemintasan permintaan dan respons

Tukar data permintaan dan data respons
Batalkan permintaan
Tukar data JSON secara automatik
Pelanggan menyokong pertahanan terhadap XSRF

Ayuh, Orang yang tidak dikenali ! (Saya tidak asing dengan anda, saya harap ia membantu)

Atas ialah kandungan terperinci Mata pengetahuan teras ini mesti dikuasai dalam komunikasi hadapan dan belakang!. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!