EN: Read in English
Dunia 9: Alatan Hebat
API, webhook dan App
Anda akan belajar: cara program bercakap dengan GitHub, dan beza antara API, webhook dan App.
Teks BM belum disemak oleh penutur asli.
Masalahnya
Kelab anda mahu skrin yang tunjuk issue baru sebaik ia masuk. Patutkah anda duduk dan muat semula GitHub sepanjang hari?
Pilih satu jawapan.
Tengok
API: Kaunter khas untuk program. Program bertanya, laman web jawab dengan data. ialah kaunter khas untuk program. Program tanya satu soalan. GitHub jawab dengan data. gh api biar anda bertanya dari terminal.
Tengok
Ketik setiap titik pada garis masa.
webhook: Loceng pintu: GitHub panggil alamat web anda bila sesuatu berlaku. ialah loceng pintu. Bila sesuatu berlaku, GitHub panggil alamat web anda. Tiada siapa perlu asyik bertanya.
Cuba
Tanya sendiri, atau diberitahu? Susun setiap kerja.
Seret kad ke dalam kotak. Atau ketik kad, kemudian ketik kotak.
Tengok
GitHub App: Pembantu robot yang anda pasang pada repo pilihan, dengan kebenaran yang perlu sahaja. ialah pembantu robot. Anda pasang ia pada repo pilihan anda. Sebelum pasang, anda nampak apa yang ia boleh buat. Bot yang label issue atau semak pull request selalunya App.
Teka
Satu app cuma hantar laporan mingguan. Ia minta izin ubah tetapan anda dan baca semua kod anda. Patutkah anda pasang?
Pilih satu jawapan.
Semak
Tabiat bagus, atau perlu baiki? Leret setiap satu.
Leret ke kanan untuk bagus, ke kiri untuk perlu baiki. Atau guna butang.
Pasang app pada repo yang ia perlukan sahaja
Anda berjaya!
Kini anda boleh bezakan API, webhook dan GitHub App.
Nak tahu lebih (pilihan)
GitHub ada REST API dan GraphQL API. Anda boleh baca data awam tanpa log masuk, tapi hadnya lebih rendah. Semakan misi FahamLah buat begitu. Webhook boleh dipasang pada repo, organisasi atau App. App guna token jangka pendek, jadi kebocoran kurang memudaratkan.
English
Your club wants a screen that shows new issues as they arrive. Do you sit and refresh GitHub all day?
An API is a service window for programs. A program asks a question. GitHub answers with data. gh api lets you ask from the terminal.
A webhook is a doorbell. When something happens, GitHub calls your web address. Nobody has to keep asking.
Ask, or get told? Sort each job.
A GitHub App is a robot helper. You install it on the repos you choose. Before you install, you see what it may do. Bots that label issues or check pull requests are often Apps.
An app only posts a weekly report. It asks to change your settings and read all your code. Do you install it?
Good habit, or needs work? Swipe each one.
You can now tell an API, a webhook and an App apart.
Anda dah siapkan ini. Latihan lagi pun bagus!
Dokumentasi rasmi: About the REST API · About webhooks · GitHub Apps overview · gh api
Anda dah belajar 25 minit. Rehat sekejap bantu otak anda.
Pecutan selesai! Fokus yang hebat. Regangkan badan seminit?