Tekomata API
Baca foto atau PDF nota jadi data dengan model AI pilihanmu, dalam bentuk baku dan dengan halaman tempat setiap nilai terbaca; 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.
Kesalahan dan batas
Setiap kesalahan berbentuk sama: {"error": {"code": "…", "message": "…"}}. Kode tidak berubah; kalimatnya untuk dibaca orang, selalu dalam bahasa Inggris, dan bisa berubah.
| HTTP | code | Artinya |
|---|---|---|
| 400 | malformed, malformed_json, invalid_idempotency_key | Isi permintaan tidak bisa dibaca, atau Idempotency-Key bukan 1 sampai 255 karakter. |
| 401 | api_credentials_required, invalid_api_key, access_token_required, invalid_access_token, access_token_expired | Tidak ada access token (api_credentials_required); client ID dan secret dikirim di tempat access token (access_token_required, keduanya hanya untuk POST /v1/token); atau token salah, dicabut, atau sudah habis. Minta token baru. |
| 402 | insufficient_credit, queue_full, not_on_plan | Saldo toko tidak cukup untuk ini atau untuk antrean bacaan yang sudah ada (isi saldo dulu), atau paket toko belum termasuk API. |
| 403 | missing_scope, not_available_to_api, scan_off | Integrasi ini tidak punya izinnya, bagian itu memang tidak dibuka untuk API, atau pindai dengan AI belum dinyalakan di server ini. |
| 404 | not_found | Tidak ada, atau milik toko lain. |
| 409 | too_many_pending, already_reported, already_decided, top_up_cancelled, read_in_progress, type_off, duplicate_name, idempotency_request_in_progress | Keadaan tidak memungkinkan permintaan itu sekarang, atau permintaan pertama dengan Idempotency-Key yang sama masih dijawab. |
| 422 | invalid, model_not_offered, file_kind, no_fields, pdf_too_many_pages, pdf_unreadable, page_out_of_range, over_max_charge, document_keeps_failing, too_many_pages, knowledge_full, invalid_amount, idempotency_key_reused, event_not_allowed | Isi permintaan salah. Pesannya menyebut apa yang perlu diperbaiki. |
| 429 | rate_limited, too_many_running, too_many_failures, scan_limit | Melewati batas permintaan per menit (tunggu sesuai Retry-After), 10 artikel sedang ditulis atau 10 gambar sedang dibuat, terlalu banyak bacaan gagal hari ini, atau 20 pindai hari ini sudah terpakai. |
| 503 | ai_unavailable, no_model, top_up_unavailable, secrets_key_missing | Tidak ada model AI yang bisa dipakai, isi saldo belum tersedia, atau server ini belum bisa menandatangani webhook. |
- Batas permintaan per menit diatur toko per integrasi (bawaan 60). Setiap jawaban membawa X-RateLimit-Limit dan X-RateLimit-Remaining.
- Access token berlaku 15 menit.
- Jawaban untuk sebuah Idempotency-Key disimpan paling sedikit 24 jam; jawaban 5xx tidak disimpan, jadi ulangannya dijalankan lagi.