Cipta API token

Tonton langkah-langkah

1. 1Platform Setup
2. 2Integrations
3. 3Developer
4. 4API tokens
5. 5Create new API token
6. 6Namakan token mengikut aplikasi yang akan menggunakannya
7. 7Tandakan hanya kebenaran yang aplikasi itu perlukan
8. 8Expiration
9. 9Create Token
10. 10Lihat atau copy token dari senarai

Cipta API token (0:33)

API token membolehkan laman web, aplikasi atau AI agent anda sendiri bekerja dengan akaun BCL anda tanpa password anda. Anda mencipta token dalam BCL dan memilih apa yang setiap token boleh buat. Hanya Admin boleh menciptanya.

Untuk endpoint dan format permintaan, lihat rujukan API BCL. Untuk menyambungkan pembantu AI, lihat Sambungkan Claude atau ChatGPT kepada BCL atau Sediakan aplikasi AI lain.

Di mana token berada

API token berada di page Integrations:

1. Di sidebar, pergi ke Platform Setup → Integrations.

   

2. Klik Developer di bahagian atas kanan untuk memaparkan kad developer sahaja. Pada kad API tokens, klik Manage. Jika anda belum ada token, butang itu tertulis Connect.

   

Panel API tokens dibuka di sebelah kanan. Ia menyenaraikan token anda dan berapa banyak daripada 10 token yang sudah anda gunakan. Kad AI agents di sebelahnya menyenaraikan aplikasi AI yang anda log masuk dengan OAuth.

Cipta token

Setiap Admin boleh ada sehingga 10 token. Untuk mencipta satu token:

1. Dalam panel API tokens, klik Create new API token.

   

2. Panel Create New API Token dibuka. Dalam Token Name, masukkan tempat token itu akan digunakan, contohnya “Kopi Kampung Website”. BCL mencadangkan satu nama, yang anda boleh tukar.

3. Di bawah Permissions, tandakan hanya apa yang aplikasi itu perlukan:

   Kebenaran	Membolehkan token	Gunakannya untuk
   API Read	Membaca form, transaksi, pelanggan, kupon dan data lain melalui API	Laporan, dashboard, sync pesanan ke sistem lain
   API Write	Mencipta payment link dan menukar data melalui API	Laman web atau aplikasi yang mencipta payment link atau mengemas kini form
   MCP Read	Membenarkan AI agent mencari data anda	Claude Code, Cursor, VS Code dan aplikasi AI lain
   MCP Write	Membenarkan AI agent mencipta dan menukar sesuatu	Aplikasi AI yang anda percayai untuk membuat perubahan

   

4. Dalam Expiration, pilih bila token itu berhenti berfungsi: Never, 30 days, 90 days, 180 days atau 365 days.

5. Klik Create Token. BCL memaparkan mesej API token "<name>" has been created. dan menambah token itu ke dalam senarai.

Kebenaran API dan kebenaran MCP adalah berasingan. Token dengan API Read dan API Write sahaja tidak berfungsi dengan AI agent, dan token MCP sahaja tidak berfungsi dengan API. API Write sahaja tidak boleh membaca, jadi tandakan API Read juga dalam kebanyakan kes. Anda tidak boleh menukar kebenaran token kemudian: cipta token baru sebagai ganti.

Apabila anda sudah ada 10 token, butang Create new API token disembunyikan. Delete dahulu token yang anda tidak guna lagi.

Guna token

Token bermula dengan bcl_. Sistem anda menghantarnya dalam header Authorization bagi setiap permintaan:

Authorization: Bearer bcl_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Accept: application/json

API berada di https://api.bcl.my/v1. Hantar juga User-Agent anda sendiri, contohnya MyShop/1.0: BCL menolak permintaan daripada user agent default skrip seperti curl atau python-requests biasa. Setiap endpoint ada dalam rujukan API BCL.

Token nampak data yang sama seperti anda. Token milik Admin yang menciptanya, dan Admin lain tidak nampak token itu dalam senarai mereka.

Lihat atau copy token semula

BCL menyimpan token anda, jadi anda boleh melihatnya semula kemudian. Dalam senarai di panel API tokens:

• Klik ikon View token (ikon mata) untuk memaparkan token di bawah namanya. Klik sekali lagi untuk menyembunyikannya.
• Klik ikon Copy token untuk copy token itu.

Senarai ini ada lajur berikut:

Lajur	Apa yang dipaparkan
Name	Nama token. Token yang sudah tamat tempoh memaparkan Expired di sebelahnya dan tidak boleh dilihat atau di-copy lagi.
Abilities	Kebenaran: read dan write untuk API, mcp:read dan mcp:write untuk AI agent
Expires	Tarikh token itu berhenti berfungsi, atau Never
Last Used	Bila sesuatu aplikasi terakhir menggunakan token itu, atau Never
Actions	Ikon View token, Copy token dan Delete token

Delete token

Delete token memutuskan akses setiap aplikasi yang menggunakannya. Untuk delete satu token:

1. Dalam panel API tokens, klik ikon Delete token (ikon tong sampah) pada baris token itu.

2. Dalam Delete API Token, klik Delete Token.

   

Mana-mana aplikasi yang menggunakan token itu hilang akses serta-merta. Token yang sudah di-delete tidak boleh dikembalikan. Jika aplikasi itu masih memerlukan akses, cipta token baru dan masukkan ke dalam aplikasi itu.

AI agents

Kad AI agents, di sebelah API tokens, menyenaraikan aplikasi AI, seperti Claude, ChatGPT atau Cursor, yang anda sambungkan dengan log masuk menggunakan akaun BCL anda (OAuth). Aplikasi ini tidak menggunakan token. Klik Manage pada kad itu untuk melihat setiap aplikasi, kebenarannya, bila anda meluluskannya dan bila ia terakhir digunakan. Selagi anda belum menyambungkan aplikasi, butang itu tertulis Connect dan panel itu memaparkan “No AI agents connected yet”.

Untuk memutuskan akses sesuatu aplikasi, klik ikon Revoke access pada barisnya, kemudian Revoke Access. Lihat Putuskan sambungan aplikasi AI.

Tips

Token ialah keys kepada akaun anda. Beberapa habit ini memastikannya selamat:

• Satu token untuk setiap aplikasi. Namakan token mengikut aplikasi itu dan, untuk tool AI, komputernya. Jika satu token bocor, anda hanya delete token itu dan yang lain terus berfungsi.
• Buang akses apabila staf berhenti. Token dan AI agent yang disambungkan milik Admin yang menciptanya, dan Admin lain tidak nampak semua itu. Minta Admin yang akan berhenti delete token mereka dahulu, dan gantikan mana-mana token yang mereka ada salinannya.
• Jangan sekali-kali paste token di tempat awam. Jangan letak token dalam kod laman web yang pelawat boleh lihat, repository Git awam, screenshot dan group chat. Jika sesuatu token terdedah, delete token itu dengan segera.
• Tetapkan tarikh tamat. Token dengan Never berfungsi sehingga seseorang delete token itu. Semak Last Used sekali-sekala dan delete token yang tiada siapa guna.

Isu-isu biasa

Bagaimana saya mendapatkan API key untuk membina integrasi saya sendiri?

Pergi ke Platform Setup → Integrations, klik Manage pada kad API tokens dan klik Create new API token. Tandakan API Read, serta API Write jika sistem anda mencipta payment link atau menukar data.

Lihat dalam langkah-langkah

Token saya hilang. Adakah saya perlu cipta token baru?

Tidak perlu. Buka kad API tokens pada page Integrations dan klik ikon View token atau Copy token pada baris token itu. BCL menyimpan token itu supaya anda boleh melihatnya semula.

Lihat dalam langkah-langkah

Kenapa saya dapat "Token does not have the 'api:write' ability"?

Token itu dicipta tanpa API Write. Kebenaran tidak boleh ditukar kemudian, jadi cipta token baru dengan API Write ditandakan dan delete token yang lama.

Lihat dalam langkah-langkah

Artikel berkaitan

• Sambungkan Claude atau ChatGPT kepada BCL
• Sediakan aplikasi AI lain (Cursor, Claude Code, VS Code & banyak lagi)
• Payload webhook payment form
• Semak apa yang dilakukan oleh AI agent anda