Mulai cepat
Masuk, buat proyek uji, buat kunci hanya dengan cakupan yang diperlukan, panggil GET /v1/tools, konfigurasikan satu layanan, lalu buat kunci live terpisah setelah pengujian penerimaan.
export GALON_API_BASE="https://api.galon.ai"
export GALON_API_KEY="gln_test_..."
curl "$GALON_API_BASE/v1/tools" -H "Authorization: Bearer $GALON_API_KEY"
Autentikasi dan isolasi
Kirim kunci API dalam header Authorization: Bearer. Setiap kunci terikat pada satu tenant, proyek, dan lingkungan. Simpan hanya di pengelola rahasia sisi server; jangan pernah menaruhnya di browser, aplikasi seluler, atau repositori sumber.
Kunci yang dibatasi per layanan
Berikan cakupan tepat seperti mail:send, domain:lookup, atau build:create. Gunakan satu kunci per aplikasi. Hindari wildcard layanan kecuali integrasi benar-benar membutuhkan semua operasi, dan segera cabut kunci yang tidak digunakan.
mail:send
domain:lookup
domain:read
build:create
build:read
artifact:read
job:read
Job asinkron dan idempotensi
Mutasi mengembalikan job. Kirim Idempotency-Key yang stabil: kunci dan maksud yang sama mengembalikan job yang sama, sedangkan kunci yang sama dengan maksud berbeda mengembalikan HTTP 409. Periksa endpoint job dan ulangi hanya permintaan yang aman atau idempoten.
POST /v1/jobs
GET /v1/jobs/{job_id}
POST /v1/jobs/{job_id}/cancel
GET /v1/builds/{job_id}/artifacts
Mengirim email
POST /v1/emails menerima from_email, subject, text atau html, dan to: satu alamat atau daftar. cc dan bcc adalah daftar opsional; to, cc, dan bcc bersama-sama memuat paling banyak 50 penerima berbeda, dan setiap penerima dihitung dalam kuota dan penggunaan yang ditagih. Setiap penerima menerima salinannya sendiri dengan tautan berhenti berlangganan satu klik miliknya, sehingga penerima bcc tidak pernah diungkapkan; penerima yang ditekan (pantulan, keluhan, berhenti berlangganan) dilewati. attachments adalah daftar berisi paling banyak 10 objek dengan filename, content (base64), dan content_type opsional; pesan yang dikodekan harus tetap di bawah 25 MB dan file yang dapat dieksekusi ditolak. scheduled_at (ISO 8601 dengan zona waktu, paling lama 72 jam sebelumnya) menunda pengiriman; POST /v1/emails/{job_id}/cancel membatalkannya selama masih dalam antrean. POST /v1/emails/batch menerima {"emails": [...]} dengan 1 hingga 100 pesan tanpa lampiran; setiap pesan menjadi job tersendiri, idempoten berdasarkan Idempotency-Key batch dan posisinya. to_email tetap diterima untuk satu penerima. Hanya pendaftaran batch yang atomik (atomic=true); eksekusi dan pengiriman berjalan independen. Percobaan ulang memerlukan daftar terurut yang persis sama; perubahan isi, ukuran, atau urutan mengembalikan HTTP 409.
POST /v1/emails
POST /v1/emails/batch
POST /v1/emails/{job_id}/cancel
Kesalahan
Perlakukan HTTP 401 sebagai kredensial tidak valid atau kedaluwarsa, 403 sebagai cakupan tidak cukup, 409 sebagai konflik idempotensi atau versi, 422 sebagai permintaan tidak valid, dan 503 sebagai ketidaktersediaan sementara.
Referensi yang dapat dibaca mesin
Gunakan kontrak OpenAPI untuk schema dan panduan integrasi LLM untuk instruksi agen. Bahasa Inggris adalah sumber kanonis; path, field, scope, dan contoh identik di setiap terjemahan.