Lisensi fitur perangkat lunak dan batas penggunaan
Izin ekspor berbeda dari 500 ekspor per bulan. RunFeature memeriksa izin; RunMeteredFeature mengonfirmasi penggunaan setelah berhasil.
Izinkan 500 ekspor per bulan
Tambahkan export ke fitur kebijakan dan kuota: export, 500, Bulanan. Secara bawaan ditolak saat habis. Untuk kelebihan, atur jumlah maksimalnya; sistem mencatat kelebihan untuk sistem pesanan Anda.
Kuota harian dan bulanan reset tengah malam UTC; kuota total tidak reset. Perubahan batas tidak menghapus pemakaian.
Konfirmasi pemakaian setelah ekspor berhasil
Berikan callback operasi ke SDK. Tugas baru memakai ID baru; percobaan ulang mempertahankan ID, fitur, dan jumlah. Jangan jalankan ID sama bersamaan di proses berbeda.
| Bahasa | Panggilan operasi terukur |
|---|---|
| Go | client.RunMeteredFeature(ctx, "export", 1, jobID, exportReport) |
| Java | client.runMeteredFeature("export", 1, jobID, this::exportReport) |
| Node.js | await client.runMeteredFeature("export", 1, jobID, exportReport) |
| Python | client.run_metered_feature("export", 1, job_id, export_report) |
| C# | await client.RunMeteredFeature("export", 1, jobID, ExportReport) |
| C++ | client.RunMeteredFeature("export", 1, jobID, exportReport) |
| Rust | client.run_metered_feature("export", 1, &job_id, || export_report())? |
| Ruby | client.run_metered_feature("export", 1, job_id) { export_report } |
| C | ln_run_metered_feature(client, "export", 1, job_id, export_report, context) |
Configure a meter for the actual feature in your policy, then generate the AI integration prompt. AI should use the language's RunMeteredFeature with a stable business operation ID, preserving that ID when retrying the same task.
Jika operasi berhasil tetapi konfirmasi gagal, percobaan ulang hanya mengonfirmasi. Crash saat operasi memblokir eksekusi ulang otomatis. Periksa hasil tersimpan, lalu gunakan ResolveMeteredFeature untuk konfirmasi atau batal. Penggunaan jarak jauh dan operasi lokal bukan satu transaksi.
Jika perlu mengendalikan reservasi sendiri
- Buat dan simpan ID tugas untuk ekspor ini.
- Reservasikan satu unit dan ekspor hanya setelah pending. committed berarti sudah selesai; jangan ulangi.
- Setelah ekspor berhasil dan hasil disimpan, panggil Commit untuk mengonfirmasi pemakaian.
- Jika ekspor gagal sebelum selesai, panggil Cancel untuk melepas reservasi tanpa mengurangi unit.
Reservasi default 15 menit, lebih pendek saat reset UTC. Pemanggil API dapat menetapkan reservation_seconds 30–3600 detik.
| Bahasa | Reservasi | Konfirmasi / Batalkan |
|---|---|---|
| Go | Reserve(ctx, "export", 1, jobID) | Commit / Cancel(ctx, hold.ID, jobID) |
| Java / Node.js | reserve("export", 1, jobID) | commit / cancel(id, jobID) |
| C | ln_reserve(client, "export", 1, jobID) | ln_commit / ln_cancel(client, id, jobID) |
| C++ / C# | Reserve("export", 1, jobID) | Commit / Cancel(id, jobID) |
| Python | reserve("export", 1, jobID) | commit / cancel(id, jobID) |
Cara membaca kolom respons
| Kolom | Arti |
|---|---|
| reservation_id / operation_id | ID reservasi dan ID tugas asli; gunakan nilai yang sama saat mencoba lagi. |
| status / expires_at | Status dan tenggat: pending menunggu selesai, committed terhitung, canceled dilepas, expired kedaluwarsa. |
| consumption.used / reserved | Pemakaian terkonfirmasi periode ini / unit yang ditahan semua reservasi aktif. |
| consumption.limit / remaining | Kuota dasar / unit dasar tersedia. remaining = max(0, limit - used - reserved), tanpa kelebihan yang diizinkan. |
| consumption.quantity / overage | Unit tugas ini / unit terkonfirmasi di atas kuota dasar; tidak menarik pembayaran pelanggan. |
| consumption.period / reset_at | Periode UTC / reset berikutnya; kuota seumur hidup memiliki reset_at = null. |
Lihat isi permintaan, respons, dan tipe kolom pada Reserve, Commit, dan Cancel di referensi API runtime.
Setelah berhasil, jangan batalkan atau ekspor ulang. Simpan ID dan hasil lalu ulangi Commit. Jika reservasi kedaluwarsa, simpan tugas untuk rekonsiliasi. Pemakaian jarak jauh dan operasi lokal bukan satu transaksi atomik.
Consume tetap langsung menghitung. Gunakan reservasi agar pekerjaan gagal tidak terhitung. Semua endpoint pemakaian fitur perlu koneksi dan tidak masuk empat operasi API berbayar platform.