BALL PICKER Guide API
Gunakan chatbot ini dari kode, situs web, atau aplikasi seluler kamu sendiri: API permintaan/respons yang sederhana, dokumen OpenAPI dan Postman, serta Connect agar pengguna kamu bisa masuk dengan chatbot ini.
Dokumentasi
Impor dokumen OpenAPI atau koleksi Postman untuk mencoba setiap endpoint.
Contoh permintaan
curl https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/chat \
-H "Authorization: Bearer c6k_your_key" \
-H "Content-Type: application/json" \
-d '{"messages":[{"role":"user","content":"Hello!"}],"lang":"id"}'Permintaan mengikuti paket chatbot ini, permintaan harian gratis, dan saldo, sama seperti chat.
Endpoint publik
Tanpa kunci: profil chatbot dan artikel blog yang sudah terbit.
curl https://ball-picker.chatbot6.com/api/v1/bots/ball-picker?lang=id curl https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/posts curl https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/posts/<id>
Server MCP
Hubungkan alamat ini di klien MCP mana pun. Tanpa kunci ia membaca informasi publik, dan dengan kunci ia bisa mengobrol.
Gunakan BALL PICKER Guide di ChatGPT, Claude, Cursor, atau VS Code. Dengan kunci Anda, AI dapat chat dengan BALL PICKER Guide; kunci pemilik juga dapat mengelola postingan blog.
Alamat server
Klien yang dapat mengirim header menggunakan alamat ini dengan header Authorization: Bearer <key>.
Alamat dengan kunci
Untuk aplikasi yang tidak dapat mengirim header (ChatGPT, Claude.ai). Kunci ada di dalam alamat: jaga kerahasiaannya seperti kata sandi.
Atur langkah demi langkah
Pilih aplikasi Anda dan ikuti langkahnya. Hanya butuh sekitar satu menit.
Claude (claude.ai dan Claude Desktop)
- Buka Claude lalu masuk ke Settings, kemudian Connectors.
- Klik Add custom connector.
- Masukkan ball-picker sebagai nama dan tempel alamat dengan kunci di bawah sebagai URL server. Biarkan kolom OAuth kosong.
- Klik Add, lalu Connect jika Claude memintanya.
- Di chat baru, buka menu alat (ikon slider) dan aktifkan ball-picker.
- Ajukan pertanyaan, misalnya: tampilkan chatbot saya dan statusnya.
Claude Code
- Jalankan perintah ini di terminal Anda:
claude mcp add --transport http ball-picker https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp \ --header "Authorization: Bearer your_key"
- Jalankan Claude Code dan ketik /mcp untuk memastikan ball-picker sudah terhubung.
- Bertanyalah dengan bahasa sehari-hari; Claude Code memanggil alat ball-picker saat diperlukan.
ChatGPT
- Buka ChatGPT di web lalu masuk ke Settings, kemudian Apps and Connectors, kemudian Advanced settings, dan aktifkan Developer mode.
- Kembali ke Apps and Connectors dan klik Create.
- Masukkan ball-picker sebagai nama dan tempel alamat dengan kunci di bawah sebagai URL server MCP.
- Pilih No authentication, konfirmasikan bahwa Anda memercayai aplikasi ini, lalu klik Create.
- Di chat baru, klik tombol plus, pilih Developer mode, lalu pilih ball-picker.
- Ajukan pertanyaan; ChatGPT meminta persetujuan Anda sebelum tindakan yang mengubah data.
Cursor
- Buka Cursor Settings, lalu MCP, lalu Add new MCP server. Anda juga dapat mengedit ~/.cursor/mcp.json secara langsung.
- Tempel konfigurasi ini lalu simpan:
{ "mcpServers": { "ball-picker": { "url": "https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp", "headers": { "Authorization": "Bearer your_key" } } } } - Pastikan ball-picker menampilkan titik hijau, lalu gunakan dalam mode Agent.
VS Code (GitHub Copilot)
- Buat file .vscode/mcp.json di proyek Anda, atau jalankan perintah MCP: Add Server.
- Tempel konfigurasi ini lalu simpan:
{ "servers": { "ball-picker": { "type": "http", "url": "https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp", "headers": { "Authorization": "Bearer your_key" } } } } - Klik Start di atas server, buka Copilot Chat dalam mode Agent, lalu aktifkan alat ball-picker.
Windsurf, Gemini CLI, dan klien lainnya
- Klien apa pun yang mendukung MCP jarak jauh melalui Streamable HTTP dapat digunakan: pakai alamat server dan header Authorization: Bearer <key>.
- Jika klien Anda hanya menjalankan server lokal (stdio), seperti Claude Desktop versi lama, tambahkan konfigurasi ini. Konfigurasi ini memakai mcp-remote dan memerlukan Node.js:
{ "mcpServers": { "ball-picker": { "command": "npx", "args": [ "-y", "mcp-remote", "https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp?key=your_key" ] } } } - Mulai ulang klien dan cari alat ball-picker.
Connect: masuk dengan chatbot ini
Biarkan pengguna situs web atau aplikasi seluler kamu masuk dengan chatbot ini dan chat lewat aplikasi kamu. Menggunakan OAuth 2.0 dengan PKCE.
Arahkan pengguna ke halaman persetujuan
/id/connect?client_id=<client_id>&redirect_uri=<redirect_uri>&state=<state>&code_challenge=<S256(code_verifier)>&code_challenge_method=S256
Tukarkan kode yang diterima dengan kunci
curl https://ball-picker.chatbot6.com/api/v1/connect/token \
-H "Content-Type: application/json" \
-d '{"grant_type":"authorization_code","code":"<code>","client_id":"<client_id>","redirect_uri":"<redirect_uri>","code_verifier":"<code_verifier>"}'