Galon Cloud
Galon API v1

Integrasikan Galon Cloud

Buat proyek, terbitkan kunci API dengan hak minimum, temukan alat yang diizinkan, lalu panggil API dari server Anda.

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.