Ringkasan integrasi API

API Lex adalah satu API HTTPS yang dipakai oleh semua aplikasi Lex. Apa pun yang bisa dilakukan aplikasi-aplikasi itu, bisa Anda lakukan dari frontend, backend, atau skrip Anda sendiri: mengelola bot, chat dengan bot, streaming balasan, menyetujui aksi, menghubungkan akun, dan menjalankan jadwal.

Aplikasi dan domain

Apa	Di mana
Lex (aplikasi chat)	lexcetha.com
Platform kontributor (membuat Mini Program)	platform.lexcetha.com
API	https://api.lexcetha.com/api/v1
Dokumentasi ini	docs.lexcetha.com

Semua path di dokumentasi ini relatif terhadap base URL API, jadi POST /agent-runs berarti POST https://api.lexcetha.com/api/v1/agent-runs.

Konsep inti

• Workspace (tenant). Setiap pengguna bekerja di dalam sebuah workspace. Bot, connector, jadwal, dan dokumen milik workspace itu, dan peran pengguna di sana (owner, admin, member, contributor) menentukan apa yang boleh ia ubah.
• Bot. Asisten dengan instruksi, mode bawaan, skill, dan akses connector sendiri. Setiap bot punya satu thread chat per pengguna.
• Run. Mengirim pesan memulai sebuah agent run. Run berpikir, memanggil tool, bisa berhenti menunggu persetujuan Anda, lalu selesai dengan balasan. Anda mengikutinya secara langsung lewat Server-Sent Events.
• Mode. nalar (cepat), patih (seimbang, bawaan), dan cendikia (mendalam, banyak langkah). Pilih per pesan atau atur sebagai bawaan bot.
• Approval. Aksi membaca berjalan sendiri; apa pun yang mengirim, membuat, mengubah, atau menghapus di luar Lex menunggu persetujuan Anda, kecuali admin workspace mengizinkannya berjalan otomatis.

Request pertama

# 1. Login dan simpan cookie sesi
curl -c cookies.txt -X POST https://api.lexcetha.com/api/v1/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"email":"anda@contoh.com","password":"password-anda"}'

# 2. Siapa saya?
curl -b cookies.txt https://api.lexcetha.com/api/v1/me

Lanjutkan ke Autentikasi, lalu Bot & chat.