Untuk developer

Tekomata API

Baca foto atau PDF nota jadi data dengan model AI pilihanmu, dalam bentuk baku, dengan halaman dan letak setiap nilai di dokumen; tulis artikel blog dengan AI, lalu dengar hasilnya lewat webhook. Lihat saldo dan isi saldo lewat transfer bank. Dibayar dari saldo Tekomata toko — bisa langsung dicoba di bawah dengan access token integrasimu.

Mulai dalam tiga langkah

  1. Pemilik toko membuat integrasi di Pengaturan → Integrasi API, memilih izinnya, lalu memberimu client ID dan client secret.
  2. Tukar client ID dan secret jadi access token. Token berlaku 15 menit; minta lagi kalau sudah habis. Tidak ada refresh token — client secret-mu sudah cukup untuk minta yang baru.
    curl -s -u "$CLIENT_ID:$CLIENT_SECRET"   -X POST https://api.tekomata.com/v1/token
    # {"access_token":"tka_…","token_type":"Bearer","expires_in":900}
  3. Di tab Referensi API, klik Authorize dan tempel access token-nya, buka endpoint-nya, klik Try it out, isi kolomnya, lalu Execute. Buka Referensi API →

Uji coba di halaman ini memanggil API sungguhan. Setiap artikel yang jadi dan dokumen yang terbaca dipotong dari saldo toko — token AI sesuai biaya, ditambah tarif dasar paketnya — dan jumlahnya ada di kolom charged pada balasannya.

Yang bisa dilakukan

Baca dokumen (OCR)

Foto atau PDF nota, faktur, atau PO dibaca AI menjadi data sesuai jenis dokumen yang dibuat toko. Kamu boleh memilih vendor dan model AI untuk setiap bacaan, dan melihat harganya per halaman.

Artikel blog dengan AI

Kirim topik, AI menulis artikel lengkap dengan judul dan bagian-bagiannya. Bisa ditunggu langsung, atau berjalan di latar belakang dan dikabari lewat webhook.

Gambar dengan AI

Kirim perintah, AI menggambarnya dalam bentuk 1:1, 4:5, atau 9:16. Berjalan di latar belakang dan dikabari lewat webhook.

Saldo & isi saldo

Lihat saldo toko dan paketnya, minta isi saldo, laporkan transfernya, lalu dengar keputusannya lewat webhook.

Dasar

  • Alamat API: https://api.tekomata.com, semua di bawah /v1. JSON masuk, JSON keluar, UTF-8.
  • Satu integrasi milik satu toko. Setiap panggilan membaca dan menulis data toko itu saja; tidak ada parameter untuk memilih toko.
  • Uang dalam rupiah, tidak pernah pecahan desimal biasa (float). Saldo, harga, batas dan "charged" berupa angka bulat; "amount" dan "credited" pada isi saldo berupa string desimal, misalnya "100000.0000".
  • Semua fitur AI dibayar dari saldo Tekomata toko: biayanya dalam rupiah, sesuai harga di tekomata.com/pricing, dan jawaban API menyebut totalnya di "charged". Yang ditolak sebelum AI ditanya tidak ditagih.
  • Pekerjaan AI berjalan di latar belakang: panggilan menjawab 202 dengan id, lalu webhook mengabari saat selesai. Bertanya berulang (polling) tetap bisa, tapi webhook lebih hemat batas permintaanmu. Satu-satunya yang menunggu adalah POST /v1/blog/generate: ia menjawab 200 dengan artikelnya.
  • Kirim header "Idempotency-Key" (misalnya UUID baru per permintaan) di setiap panggilan yang menulis. Diulang dengan kunci yang sama dalam paling sedikit 24 jam, jawabannya jawaban pertama (header Idempotent-Replayed: true): tidak ada yang dibaca, ditulis, atau ditagih dua kali.
  • Tandai bacaan, artikel, dan gambar dengan "clientReference" (id milikmu, sampai 200 karakter). Ia kembali di jawaban dan di webhook, dan bacaan bisa dicari dengannya: GET …/runs?clientReference=….
  • Perubahan API dicatat di tekomata.com/developers/changelog. Kolom baru bisa muncul kapan saja; yang dihapus atau diganti namanya, dan model AI yang dimatikan atau diubah harganya, diumumkan di sana paling lambat 30 hari sebelumnya.