5.9 KiB
Mengguna API
Gambaran Keseluruhan
API membuka peluang tanpa batas untuk pembangunan web yang kreatif! Dalam tugasan ini, anda akan memilih API luaran dan membina sambungan pelayar yang menyelesaikan masalah sebenar atau menyediakan fungsi yang bernilai kepada pengguna.
Arahan
Langkah 1: Pilih API Anda
Pilih API daripada senarai API awam percuma yang telah disusun ini. Pertimbangkan kategori berikut:
Pilihan popular untuk pemula:
- Hiburan: Dog CEO API untuk gambar anjing secara rawak
- Cuaca: OpenWeatherMap untuk data cuaca semasa
- Petikan: Quotable API untuk petikan inspirasi
- Berita: NewsAPI untuk tajuk berita terkini
- Fakta Menarik: Numbers API untuk fakta menarik tentang nombor
Langkah 2: Rancang Sambungan Anda
Sebelum mula menulis kod, jawab soalan perancangan ini:
- Masalah apa yang diselesaikan oleh sambungan anda?
- Siapa pengguna sasaran anda?
- Data apa yang akan disimpan dalam storan tempatan?
- Bagaimana anda akan menangani kegagalan API atau had kadar?
Langkah 3: Bina Sambungan Anda
Sambungan anda harus merangkumi:
Ciri Wajib:
- Input borang untuk sebarang parameter API yang diperlukan
- Integrasi API dengan pengendalian ralat yang betul
- Storan tempatan untuk keutamaan pengguna atau kunci API
- Antara muka pengguna yang bersih dan responsif
- Status pemuatan dan maklum balas pengguna
Keperluan Kod:
- Gunakan ciri JavaScript moden (ES6+)
- Laksanakan async/await untuk panggilan API
- Sertakan pengendalian ralat yang betul dengan blok try/catch
- Tambahkan komen bermakna yang menerangkan kod anda
- Ikuti format kod yang konsisten
Langkah 4: Uji dan Perbaiki
- Uji sambungan anda dengan pelbagai input
- Tangani kes tepi (tiada internet, respons API tidak sah)
- Pastikan sambungan anda berfungsi selepas pelayar dimulakan semula
- Tambahkan mesej ralat yang mesra pengguna
Cabaran Bonus
Tingkatkan sambungan anda ke tahap seterusnya:
- Tambahkan beberapa titik akhir API untuk fungsi yang lebih kaya
- Laksanakan caching data untuk mengurangkan panggilan API
- Cipta pintasan papan kekunci untuk tindakan biasa
- Tambahkan ciri eksport/import data
- Laksanakan pilihan penyesuaian pengguna
Keperluan Penyerahan
- Sambungan pelayar yang berfungsi yang berjaya diintegrasikan dengan API pilihan anda
- Fail README yang menerangkan:
- API yang anda pilih dan sebabnya
- Cara memasang dan menggunakan sambungan anda
- Sebarang kunci API atau persediaan yang diperlukan
- Tangkapan skrin sambungan anda semasa berfungsi
- Kod yang bersih dan dikomen mengikut amalan JavaScript moden
Rubrik
| Kriteria | Cemerlang (90-100%) | Mahir (80-89%) | Sedang Membangun (70-79%) | Permulaan (60-69%) |
|---|---|---|---|---|
| Integrasi API | Integrasi API yang sempurna dengan pengendalian ralat yang menyeluruh dan pengurusan kes tepi | Integrasi API yang berjaya dengan pengendalian ralat asas | API berfungsi tetapi pengendalian ralat terhad | Integrasi API mempunyai masalah besar |
| Kualiti Kod | JavaScript moden yang bersih, dikomen dengan baik, mengikut amalan terbaik | Struktur kod yang baik dengan komen yang mencukupi | Kod berfungsi tetapi memerlukan organisasi yang lebih baik | Kualiti kod yang lemah dengan komen yang minimum |
| Pengalaman Pengguna | Antara muka yang kemas dengan status pemuatan dan maklum balas pengguna yang sangat baik | Antara muka yang baik dengan maklum balas pengguna asas | Antara muka asas yang berfungsi dengan memadai | Pengalaman pengguna yang lemah dengan antara muka yang mengelirukan |
| Storan Tempatan | Penggunaan storan tempatan yang canggih dengan pengesahan dan pengurusan data | Pelaksanaan storan tempatan yang betul untuk ciri utama | Pelaksanaan storan tempatan asas | Penggunaan storan tempatan yang minimum atau tidak betul |
| Dokumentasi | README yang komprehensif dengan arahan persediaan dan tangkapan skrin | Dokumentasi yang baik meliputi kebanyakan keperluan | Dokumentasi asas yang kekurangan beberapa butiran | Dokumentasi yang lemah atau tiada |
Petua Memulakan
- Mulakan dengan mudah: Pilih API yang tidak memerlukan pengesahan yang kompleks
- Baca dokumentasi: Fahami sepenuhnya titik akhir dan respons API pilihan anda
- Rancang UI anda: Lakarkan antara muka sambungan anda sebelum mula menulis kod
- Uji dengan kerap: Bina secara berperingkat dan uji setiap ciri semasa anda menambahnya
- Tangani ralat: Sentiasa anggap panggilan API mungkin gagal dan rancang dengan sewajarnya
Sumber
- Dokumentasi Sambungan Pelayar
- Panduan Fetch API
- Tutorial Storan Tempatan
- Pengendalian dan Penguraian JSON
Selamat membina sesuatu yang berguna dan kreatif! 🚀
Penafian:
Dokumen ini telah diterjemahkan menggunakan perkhidmatan terjemahan AI Co-op Translator. Walaupun kami berusaha untuk ketepatan, sila ambil perhatian bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya harus dianggap sebagai sumber yang berwibawa. Untuk maklumat penting, terjemahan manusia profesional adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini.