Apa Itu API? Panduan Mudah untuk Pembina Aplikasi
API (antara muka pengaturcaraan aplikasi) ialah cara yang ditetapkan bagi satu perisian meminta data daripada perisian lain atau menyuruhnya melakukan sesuatu. Aplikasi anda menghantar permintaan dalam format yang dipersetujui — “berikan saya tempahan esok,” “caj kad ini €20,” “ringkaskan teks ini” — dan sistem lain menghantar balik respons berstruktur. API ialah cara bahagian-bahagian aplikasi berkomunikasi, dan cara aplikasi anda menggunakan perkhidmatan luar seperti pembayaran, e-mel, peta dan AI.
Mengapa API penting apabila anda membina dengan AI
Hampir setiap aplikasi berguna terdiri daripada bahagian yang berkomunikasi melalui API:
- Di dalam aplikasi anda, skrin dalam pelayar memanggil API bahagian belakang anda sendiri untuk memuatkan dan menyimpan data.
- Di luar aplikasi anda, bahagian belakang anda memanggil API syarikat lain: Stripe untuk menerima pembayaran, pembekal e-mel untuk menghantar resit, pembekal model AI untuk menjana teks.
Apabila anda meminta pembina AI untuk “menerima pembayaran” atau “tambah ringkasan AI,” apa yang sebenarnya dilakukannya ialah menulis kod yang memanggil API. Mengetahui asasnya membantu anda memahami apa yang AI perlukan daripada anda (biasanya akaun dengan perkhidmatan itu dan kunci API), di mana perkara boleh tersilap, dan berapa kosnya.
Analogi harian
Bayangkan sebuah restoran. Anda tidak masuk ke dapur dan memasak sendiri. Anda membaca menu, memberitahu pelayan apa yang anda mahu dalam cara yang difahami dapur, dan pelayan membawa balik makanan anda — atau memberitahu bahawa hidangan itu telah habis.
- Menu ialah dokumentasi API: senarai apa yang boleh anda minta dan cara memintanya.
- Pelayan ialah API: satu cara yang dipersetujui bagi permintaan masuk dan respons keluar.
- Dapur ialah sistem lain: anda tidak perlu tahu bagaimana ia berfungsi di dalam.
- Pesanan anda ialah permintaan; pinggan ialah respons.
Dapur boleh menukar ketuhar dan kakitangannya tanpa menjejaskan anda, selagi menunya kekal sama. Itulah nilai sebenar API: ia membolehkan dua sistem bekerjasama tanpa mana-mana satu perlu tahu bagaimana yang lain dibina.
Cara permintaan API web berfungsi
Kebanyakan API yang anda akan temui ialah API web yang berfungsi melalui HTTP, protokol yang sama digunakan oleh pelayar anda. Setiap permintaan mempunyai beberapa bahagian:
| Bahagian | Apa itu | Contoh |
|---|---|---|
| Kaedah | Jenis tindakan | GET (baca), POST (cipta) |
| URL / titik akhir | Alamat perkara yang anda tindakkan | https://api.example.com/bookings |
| Pengepala (headers) | Maklumat tambahan, termasuk siapa anda | Authorization: Bearer <kunci anda> |
| Badan (body) | Data yang anda hantar, untuk cipta dan kemas kini | {"name": "Lena", "time": "14:00"} |
Dan setiap respons mempunyai:
| Bahagian | Apa itu | Contoh |
|---|---|---|
| Kod status | Nombor yang menyatakan hasilnya | 200 OK, 201 Dicipta, 404 Tidak Dijumpai |
| Badan | Data yang dipulangkan, biasanya dalam JSON | {"id": 5001, "status": "confirmed"} |
JSON (JavaScript Object Notation) ialah format teks mudah bagi nama dan nilai dalam kurungan kerinting. Ia cara piawai API web bertukar data.
REST: gaya yang paling biasa
REST ialah konvensyen yang digunakan secara meluas untuk mereka bentuk API web. Setiap jenis perkara mendapat URL sendiri, dan kaedah standard menyatakan apa yang anda lakukan kepadanya. Berikut ialah rupa REST API untuk aplikasi tempahan:
| Kaedah | Titik akhir | Apa yang dilakukannya |
|---|---|---|
GET | /api/bookings | Senaraikan tempahan |
GET | /api/bookings/5001 | Dapatkan satu tempahan |
POST | /api/bookings | Cipta tempahan baharu |
PATCH | /api/bookings/5001 | Tukar sebahagian tempahan, seperti masanya |
DELETE | /api/bookings/5001 | Batalkan (padam) tempahan |
PUT juga wujud dan secara konvensyen menggantikan keseluruhan rekod, manakala PATCH hanya menukar medan yang anda hantar.
Kod status yang paling kerap anda lihat:
| Kod | Maksud |
|---|---|
200 / 201 | Berjaya / dicipta |
400 | Permintaan tidak sah — sesuatu dalam apa yang anda hantar salah atau hilang |
401 | Tidak disahkan — tiada log masuk atau kunci yang sah |
403 | Dilarang — anda dikenali, tetapi tidak dibenarkan melakukan ini |
404 | Tidak dijumpai |
429 | Terlalu banyak permintaan — anda telah mencapai had kadar |
500 | Pelayan mengalami ralat |
Apabila aplikasi anda rosak, kod status selalunya petunjuk terpantas. 401 daripada pembekal pembayaran biasanya bermakna kunci API hilang atau salah; 429 bermakna anda memanggil terlalu kerap.
REST bukan satu-satunya gaya — GraphQL dan API gaya RPC juga wujud — tetapi REST ialah yang paling banyak digunakan oleh perkhidmatan dan bahagian belakang yang dibina AI.
Contoh kerja: pengesahan tempahan
Apabila pelanggan menempah potongan rambut dalam aplikasi salon, beberapa panggilan API mungkin berlaku dalam sehingga satu atau dua saat:
- Halaman tempahan dalam pelayar menghantar
POST /api/bookingsdengan perkhidmatan, masa dan butiran pelanggan kepada bahagian belakang anda. - Bahagian belakang anda menyemak slot itu kosong, menyimpan tempahan dalam pangkalan data, dan memulangkan
201 Created. - Bahagian belakang anda memanggil API pembekal e-mel dengan kunci rahsianya: “hantar pengesahan ini kepada lena@example.com.”
- Jika ada deposit, bahagian belakang anda meminta API pembekal pembayaran untuk mencipta sesi checkout dan menghantar pelanggan ke sana.
- Kemudian, pembekal pembayaran memanggil aplikasi anda untuk memberitahu bahawa pembayaran berjaya. Panggilan terbalik itu ialah webhook.
Dua langkah pertama ialah API anda sendiri antara frontend dan backend. Langkah 3–5 ialah API pihak ketiga.
Istilah biasa dijelaskan
| Istilah | Maksudnya |
|---|---|
| Titik akhir (endpoint) | Satu URL khusus yang dibalas oleh API. |
| Kunci API | Rentetan rahsia yang mengenal pasti aplikasi anda kepada satu perkhidmatan. Layan seperti kata laluan. |
| Pengesahan (authentication) | Membuktikan siapa yang memanggil — dengan kunci, token atau log masuk. Lihat apa itu pengesahan. |
| Had kadar (rate limit) | Had berapa banyak permintaan yang boleh anda buat dalam satu tempoh. |
| SDK | Pustaka kod sedia dibuat yang memudahkan memanggil API tertentu. |
| Dokumentasi | “Menu”: titik akhir yang wujud, apa yang diterima dan dipulangkannya. |
| Kotak pasir / mod ujian (sandbox / test mode) | Versi perkhidmatan untuk ujian tanpa wang sebenar atau data sebenar. |
| Webhook | Panggilan daripada perkhidmatan lain ke dalam aplikasi anda apabila sesuatu berlaku. |
Kesilapan dan salah faham biasa
- Meletakkan kunci rahsia di bahagian hadapan. Apa-apa dalam kod yang berjalan dalam pelayar boleh dilihat oleh sesiapa yang melawat. Kunci rahsia mesti kekal di pelayan, dalam pembolehubah persekitaran atau rahsia.
- Menampal kunci dalam sembang. Sejarah sembang mungkin disimpan. Gunakan ciri rahsia pembina anda, dan tukar mana-mana kunci yang terdedah.
- Menganggap API percuma. Banyak API mengenakan bayaran setiap permintaan atau setiap unit penggunaan — API model AI mengenakan bayaran mengikut token. Semak harga dan tetapkan had perbelanjaan. Lihat cara menggunakan API LLM.
- Tidak mengendalikan kegagalan. Perkhidmatan luar tumbang, tamat masa dan mencapai had. Minta mesej ralat yang munasabah dan cubaan semula.
- Mempercayai pelayar. API anda sendiri mesti menyemak kebenaran sendiri. Menyembunyikan butang tidak menghalang seseorang memanggil titik akhir secara terus.
- Menggunakan kunci langsung semasa menguji. Gunakan kunci mod ujian sehingga anda bersedia untuk dilancarkan.
Apa yang patut diminta daripada pembina AI anda
- “API luar manakah yang digunakan aplikasi ini, dan berapa kos setiap satu?”
- “Panggil API pembayaran dari pelayan sahaja. Baca kunci daripada pembolehubah persekitaran.”
- “Senaraikan setiap titik akhir dalam API kami, apa yang dilakukannya dan siapa yang dibenarkan memanggilnya.”
- “Semak di pelayan bahawa pengguna yang log masuk memiliki tempahan itu sebelum mengemas kini atau memadamnya.”
- “Jika API e-mel gagal, simpan tempahan juga dan log ralat itu.”
- “Gunakan mod ujian pembekal buat masa ini.”
API dalam Mythex
Mythex boleh membina API anda sendiri — sebagai sebahagian daripada aplikasi web, atau sebagai bahagian belakang berasingan dalam Node, Python (FastAPI), C# atau Java yang berjalan bersama bahagian hadapan anda — dan menulis kod yang memanggil perkhidmatan luar. Anda menambah kunci mereka sebagai rahsia projek dan bukan dalam sembang, dan ia tersedia untuk aplikasi anda dalam pratonton dan selepas diterbitkan. Dokumentasi mempunyai resipi untuk mengintegrasikan mana-mana API dan membina bahagian belakang REST API.
Soalan lazim
Apakah API dalam istilah mudah?
API (antara muka pengaturcaraan aplikasi) ialah cara yang ditetapkan bagi satu perisian meminta data daripada perisian lain atau menyuruhnya melakukan sesuatu. Aplikasi anda menghantar permintaan dalam format yang dipersetujui, dan sistem lain menghantar balik respons — seperti data cuaca, hasil pembayaran atau jawapan yang dijana AI.
Apakah REST API?
REST API ialah gaya API web yang biasa di mana setiap jenis perkara (tempahan, pelanggan) mempunyai URL, dan anda menggunakan kaedah HTTP standard — GET untuk membaca, POST untuk mencipta, PUT atau PATCH untuk mengemas kini, DELETE untuk memadam. Data biasanya dipulangkan dalam JSON.
Apakah kunci API dan di mana saya patut menyimpannya?
Kunci API ialah rentetan rahsia yang mengenal pasti aplikasi anda kepada satu perkhidmatan dan selalunya membolehkannya membelanjakan wang atau mengakses data. Simpannya dalam pembolehubah persekitaran atau rahsia projek anda di pelayan, jangan sekali-kali dalam kod yang berjalan dalam pelayar dan jangan dalam repositori awam.
Apakah perbezaan antara API dan webhook?
Dengan API, aplikasi anda meminta sesuatu daripada perkhidmatan lain apabila ia mahukannya. Dengan webhook, perkhidmatan lain memanggil aplikasi anda apabila sesuatu berlaku — contohnya, pembekal pembayaran memberitahu anda bahawa pembayaran berjaya.