Struktur API Mesti Tahu untuk Pembangun Web (dengan contoh)

Gaya API Pembangunan Web: Gambaran Keseluruhan Praktikal

Panggilan API antara perkhidmatan adalah asas kepada pembangunan web. Panduan ini meneroka beberapa gaya seni bina API biasa dengan contoh praktikal.

API REHAT

REST (Pemindahan Negeri Perwakilan) ialah gaya API yang paling lazim. Kesederhanaannya—membuat permintaan HTTP untuk mengakses sumber—menjadikannya mesra pemula.

Contoh ini menunjukkan memaparkan emoji GitHub dalam penyemak imbas anda menggunakan API RESTful:

Soket Web

Untuk menolak mesej pelayan ke pelanggan, WebSockets sesuai. Ia membolehkan komunikasi dua hala yang berterusan.

Contoh ini menghantar mesej ke echo.websocket.org, yang menggemakannya kembali:

GraphQL API

GraphQL menyerupai REST tetapi menawarkan penyesuaian sisi klien bagi struktur data tindak balas.

Contoh ini mendapatkan semula data Pokémon tertentu (ID, ketinggian, berat, kebahagiaan asas dan kadar tangkapan) berdasarkan nama Pokémon. Ubah suai pertanyaan untuk mendapatkan semula medan tambahan.

Webhooks

Webhook memudahkan komunikasi dipacu acara. Apabila peristiwa dicetuskan, perkhidmatan webhook menghantar permintaan HTTP POST ke URL yang dipratentukan. Ini biasanya digunakan dalam saluran paip CI/CD dan juga menguasakan bot GitHub.

Contoh ini menggunakan smee.io untuk pengalihan webhook. Walaupun pengirim dan penerima berada dalam aplikasi yang sama untuk demonstrasi, dalam senario dunia sebenar, mereka berada di pelayan yang berasingan. Titik akhir pencetus menghantar mesej ke smee.io, yang memajukannya ke titik akhir penerima. Anda boleh mengubah suai mesej dengan memotong kotak pasir.

Perbandingan Gaya API

API Style	Architecture Style	Data Format	Communication Workflow
RESTful	HTTP-based, standard HTTP methods	JSON, XML	Client requests; server responds.
WebSockets	Bidirectional, persistent connection	Text, Binary	Client and server establish a persistent connection for real-time communication.
GraphQL	Query language, client-defined response	JSON	Client sends a query; server returns the specified data.
Webhook	Event-driven, server initiates request	JSON	Event triggers server to send an HTTP request to a client-defined URL.

Bacaan Lanjut

• Gaya Seni Bina API ByteByteGo
• Dokumentasi GraphQL PokéAPI
• API GrafQL

Atas ialah kandungan terperinci Struktur API Mesti Tahu untuk Pembangun Web (dengan contoh). Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!