{ "components": { "schemas": { "AccountClosure": { "additionalProperties": false, "properties": { "case_id": { "format": "uuid", "type": "string" }, "completed_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "confirmed_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "created_at": { "format": "date-time", "type": "string" }, "due_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "id": { "format": "uuid", "type": "string" }, "scope": { "enum": [ "account", "workspace" ], "type": "string" }, "status": { "type": "string" } }, "required": [], "type": "object" }, "AccountClosureInput": { "additionalProperties": false, "properties": { "confirm": { "const": true, "type": "boolean" }, "current_password": { "type": "string" }, "request_id": { "type": "string" }, "scope": { "enum": [ "account", "workspace" ], "type": "string" } }, "required": [ "scope", "current_password", "confirm", "request_id" ], "type": "object" }, "AccountClosureList": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/AccountClosure" }, "type": "array" }, "now": { "format": "date-time", "type": "string" }, "total": { "type": "integer" } }, "required": [], "type": "object" }, "AccountClosureReview": { "additionalProperties": false, "properties": { "acknowledge_finance": { "type": "boolean" }, "approve": { "type": "boolean" }, "decision": { "type": "string" } }, "required": [ "approve", "decision" ], "type": "object" }, "AccountCorrection": { "additionalProperties": false, "properties": { "current_password": { "type": "string" }, "email": { "format": "email", "type": "string" }, "name": { "maxLength": 120, "type": "string" } }, "required": [ "name", "current_password" ], "type": "object" }, "Activation": { "additionalProperties": false, "example": { "created_at": "2026-10-18T00:00:00Z", "device_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "device_name": "Office PC", "generation": 1, "id": "44444444-4444-4444-8444-444444444444", "last_seen_at": "2026-10-18T00:00:00Z", "license_id": "33333333-3333-4333-8333-333333333333", "product_id": "11111111-1111-4111-8111-111111111111", "released_at": null, "status": "active", "virtual_machine": false }, "properties": { "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "device_id": { "description": "Sidik jari perangkat bercakupan produk, biasanya 64 karakter heksadesimal huruf kecil, diturunkan oleh SDK.", "type": "string" }, "device_name": { "description": "Label perangkat yang dapat dibaca manusia, bukan identitas keamanan.", "type": "string" }, "generation": { "description": "Generasi aktivasi yang digunakan untuk membatalkan kredensial perangkat lama.", "type": "integer" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "last_seen_at": { "description": "Stempel waktu aktivitas perangkat terakhir yang diamati server, UTC.", "format": "date-time", "type": "string" }, "lease_expires_at": { "anyOf": [ { "description": "Kedaluwarsa lease kursi floating; kursi kedaluwarsa dapat diambil kembali.", "format": "date-time", "type": "string" }, { "description": "Kedaluwarsa lease kursi floating; kursi kedaluwarsa dapat diambil kembali.", "type": "null" } ], "description": "Kedaluwarsa lease kursi floating; kursi kedaluwarsa dapat diambil kembali." }, "license_id": { "description": "UUID lisensi, berbeda dari rahasia lv_lic_.", "format": "uuid", "type": "string" }, "product_id": { "description": "UUID produk di ruang kerja saat ini.", "format": "uuid", "type": "string" }, "released_at": { "anyOf": [ { "description": "Stempel waktu pelepasan; null sampai dilepas.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu pelepasan; null sampai dilepas.", "type": "null" } ], "description": "Stempel waktu pelepasan; null sampai dilepas." }, "session_id": { "description": "Pengenal sesi instance floating; dapat dihilangkan untuk lisensi node-locked.", "type": "string" }, "status": { "description": "Status resource saat ini; lihat enum dan catatan operasi.", "enum": [ "active", "released" ], "type": "string" }, "virtual_machine": { "description": "Apakah SDK mendeteksi mesin virtual.", "type": "boolean" } }, "required": [ "id", "product_id", "license_id", "device_id", "virtual_machine", "device_name", "status", "generation", "created_at", "last_seen_at", "released_at" ], "type": "object" }, "ActivationList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/Activation" }, "type": "array" }, "limit": { "description": "Ukuran halaman, default 25, rentang 1–100.", "type": "integer" }, "offset": { "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "type": "integer" }, "total": { "description": "Total catatan yang cocok, bukan panjang halaman saat ini.", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "AdminPlanList": { "additionalProperties": false, "properties": { "currencies": { "items": { "pattern": "^[A-Z]{3}$", "type": "string" }, "type": "array" }, "items": { "items": { "$ref": "#/components/schemas/Price" }, "type": "array" }, "settings": { "$ref": "#/components/schemas/DefaultPlan" } }, "required": [], "type": "object" }, "AttemptList": { "additionalProperties": false, "properties": { "items": { "anyOf": [ { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/WebhookAttempt" }, "type": "array" }, { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "type": "null" } ], "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type." } }, "required": [], "type": "object" }, "Audit": { "additionalProperties": false, "properties": { "action": { "description": "Pengenal tindakan audit, seperti product.create atau license.renew.", "type": "string" }, "actor_id": { "description": "UUID akun yang bertanggung jawab atas tindakan.", "format": "uuid", "type": "string" }, "actor_kind": { "description": "Sumber tindakan: session, api_key, atau system.", "enum": [ "session", "api_key", "system" ], "type": "string" }, "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "type": "string" }, "resource_id": { "description": "UUID resource yang terdampak.", "maxLength": 36, "type": "string" } }, "required": [ "id", "action", "resource_id", "created_at" ], "type": "object" }, "AuditList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/Audit" }, "type": "array" }, "limit": { "description": "Ukuran halaman, default 25, rentang 1–100.", "type": "integer" }, "offset": { "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "type": "integer" } }, "required": [ "items", "limit", "offset" ], "type": "object" }, "AutoRenewal": { "additionalProperties": false, "properties": { "amount_cents": { "description": "Jumlah dalam seperseratus; entri ledger dapat berupa kredit positif atau debit negatif.", "minimum": 0, "type": "integer" }, "currency": { "description": "Kode mata uang huruf besar tiga huruf, seperti USD.", "type": "string" }, "enabled": { "description": "Apakah endpoint webhook diaktifkan.", "type": "boolean" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "sandbox", "live" ], "type": "string" }, "plan": { "description": "Pengenal paket penagihan stabil dari katalog yang diterbitkan.", "type": "string" }, "plan_name": { "description": "Nama tampilan paket.", "type": "string" }, "policy_version": { "description": "Revisi kebijakan layanan yang diterima saat perpanjangan otomatis disimpan.", "type": "string" }, "price_version": { "description": "Revisi harga yang dibekukan; input usang dapat menyebabkan PLAN_VERSION_CONFLICT.", "type": "string" }, "status": { "description": "Status resource saat ini; lihat enum dan catatan operasi.", "enum": [ "disabled", "enabled", "insufficient_balance", "price_changed", "plan_changed", "plan_unavailable", "account_unavailable" ], "type": "string" }, "term_months": { "description": "Jumlah bulan dalam jangka waktu yang dibeli.", "enum": [ 1, 3, 6, 12 ], "type": "integer" }, "updated_at": { "description": "Stempel waktu pembaruan terakhir dalam UTC.", "format": "date-time", "type": "string" }, "version": { "description": "Revisi konfigurasi perpanjangan otomatis.", "type": "string" } }, "required": [ "mode", "enabled", "plan", "plan_name", "currency", "price_version", "term_months", "amount_cents", "status", "version", "updated_at" ], "type": "object" }, "AutoRenewalInput": { "additionalProperties": false, "properties": { "currency": { "type": "string" }, "enabled": { "type": "boolean" }, "expected_version": { "type": "string" }, "overage_accepted": { "description": "Otorisasi eksplisit terpisah untuk kelebihan penggunaan berbayar yang ditampilkan.", "type": "boolean" }, "plan": { "type": "string" }, "policy_version": { "description": "Versi kebijakan tidak berubah yang saat ini diterbitkan. Wajib untuk tindakan yang dilindungi persetujuan setelah operator menerbitkan kebijakan, pada kedua lingkungan pembayaran.", "type": "string" }, "price_version": { "type": "string" }, "term_months": { "enum": [ 1, 3, 6, 12 ], "type": "integer" }, "terms_accepted": { "description": "Persetujuan eksplisit yang secara default tidak dicentang.", "type": "boolean" } }, "required": [ "enabled", "expected_version" ], "type": "object" }, "AutoRenewalResult": { "additionalProperties": false, "properties": { "next_renewal_at": { "anyOf": [ { "description": "Stempel waktu perpanjangan berikutnya yang diharapkan dalam UTC; dapat null jika dinonaktifkan atau tidak diperlukan.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu perpanjangan berikutnya yang diharapkan dalam UTC; dapat null jika dinonaktifkan atau tidak diperlukan.", "type": "null" } ], "description": "Stempel waktu perpanjangan berikutnya yang diharapkan dalam UTC; dapat null jika dinonaktifkan atau tidak diperlukan." }, "setting": { "$ref": "#/components/schemas/AutoRenewal", "description": "Konfigurasi perpanjangan otomatis saat ini." } }, "required": [ "setting", "next_renewal_at" ], "type": "object" }, "BatchInput": { "additionalProperties": false, "properties": { "days": { "description": "Wajib untuk renew: hari masa berlaku tambahan, 1–36500; tidak digunakan oleh operasi lain.", "maximum": 36500, "minimum": 1, "type": "integer" }, "duration_days": { "description": "Durasi bersama untuk entri create yang menghilangkan duration_days. Setiap entri dapat mengesampingkannya. Wajib untuk entri timed/trial tanpa durasi sendiri; hilangkan untuk pembuatan perpetual.", "maximum": 36500, "minimum": 1, "type": [ "integer", "null" ] }, "entries": { "description": "Wajib untuk create: 1–100 entri pelanggan; hilangkan untuk operasi lain.", "items": { "additionalProperties": false, "properties": { "customer": { "description": "Label pelanggan yang ditentukan vendor, berbeda dari email portal pelanggan.", "maxLength": 120, "type": "string" }, "customer_email": { "description": "Email portal pelanggan yang terhubung; kosong jika belum ditetapkan.", "maxLength": 254, "type": "string" }, "duration_days": { "description": "Durasi pembuatan per lisensi; mengesampingkan BatchInput.duration_days. Hilangkan untuk menggunakan durasi pembuatan bersama.", "maximum": 36500, "minimum": 1, "type": [ "integer", "null" ] } }, "required": [], "type": "object" }, "maxItems": 100, "minItems": 1, "type": "array" }, "ids": { "description": "Wajib untuk renew, revoke, dan apply_policy: 1–100 UUID lisensi berbeda; hilangkan untuk create.", "items": { "format": "uuid", "type": "string" }, "maxItems": 100, "minItems": 1, "type": "array", "uniqueItems": true }, "operation": { "description": "Nama operasi; batch mendukung create/renew/revoke/apply_policy dan permintaan offline activate/deactivate.", "enum": [ "create", "renew", "revoke", "apply_policy" ], "type": "string" }, "policy_id": { "description": "Wajib untuk create dan apply_policy: UUID kebijakan lisensi target.", "format": "uuid", "type": "string" }, "preview_token": { "description": "Token konfirmasi pratinjau terenkripsi wajib untuk apply_policy; berlaku 600 detik dan dibatalkan oleh perubahan resource.", "type": "string", "writeOnly": true }, "product_id": { "description": "Wajib untuk create: UUID produk untuk lisensi baru.", "format": "uuid", "type": "string" }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "request_id", "operation" ], "type": "object" }, "BatchItem": { "additionalProperties": false, "example": { "customer": "Order #1001", "customer_email": "buyer@example.com", "duration_days": 30, "expires_at": null, "first_activated_at": null, "id": "33333333-3333-4333-8333-333333333333", "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" }, "properties": { "customer": { "description": "Label pelanggan yang ditentukan vendor, berbeda dari email portal pelanggan.", "type": "string" }, "customer_email": { "description": "Email portal pelanggan yang terhubung; kosong jika belum ditetapkan.", "type": "string" }, "duration_days": { "description": "Hari per lisensi sejak aktivasi pertama. Wajib 1–36500 untuk penerbitan timed/trial; tidak ada/null untuk perpetual. Tidak pernah disimpan dalam kebijakan.", "type": [ "integer", "null" ] }, "expires_at": { "anyOf": [ { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "format": "date-time", "type": "string" }, { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "type": "null" } ], "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial." }, "first_activated_at": { "anyOf": [ { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu aktivasi pertama yang berhasil; null sebelum aktivasi dan tidak berubah oleh perpanjangan atau transfer.", "type": "null" } ], "description": "Stempel waktu aktivasi pertama yang berhasil; null sebelum aktivasi dan tidak berubah oleh perpanjangan atau transfer." }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "license_key": { "description": "Kunci lisensi pelanggan lengkap yang diberikan saat aktivasi. Kode inisialisasi produk dan unduhan contoh tidak berisi rahasia ini. Permintaan offline menggunakan kredensial yang diberikan SDK.", "type": "string" }, "operation": { "description": "Nama operasi; batch mendukung create/renew/revoke/apply_policy dan permintaan offline activate/deactivate.", "enum": [ "create", "renew", "revoke", "apply_policy" ], "type": "string" } }, "required": [ "id" ], "type": "object" }, "BatchResult": { "additionalProperties": false, "properties": { "count": { "description": "Jumlah dalam grup saat ini, atau jumlah catatan yang diproses batch.", "type": "integer" }, "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/BatchItem" }, "type": "array" }, "operation": { "description": "Nama operasi; batch mendukung create/renew/revoke/apply_policy dan permintaan offline activate/deactivate.", "enum": [ "create", "renew", "revoke", "apply_policy" ], "type": "string" }, "request_id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } }, "required": [ "request_id", "operation", "items", "count" ], "type": "object" }, "BillingEmailPreview": { "additionalProperties": false, "properties": { "body": { "type": "string" }, "id": { "format": "uuid", "type": "string" }, "link": { "format": "uri", "type": "string" }, "reply_to": { "description": "Email dukungan publik dan Reply-To untuk email penagihan. Kosong menyembunyikan kontak. Tidak mengubah alamat SMTP From yang ada atau membuat kotak masuk.", "maxLength": 254, "type": "string" }, "subject": { "type": "string" }, "to": { "format": "email", "type": "string" } }, "required": [ "id", "to", "subject", "body", "link" ], "type": "object" }, "BillingEmailTestInput": { "additionalProperties": false, "properties": { "kind": { "enum": [ "purchase_success", "expiry_reminder", "auto_renewal_success", "auto_renewal_problem" ], "type": "string" }, "locale": { "default": "zh", "enum": [ "zh", "zh-hant", "en", "es", "hi", "ar", "fr", "bn", "pt", "id", "ur" ], "type": "string" }, "to": { "format": "email", "type": "string" } }, "required": [ "kind", "to" ], "type": "object" }, "BillingJob": { "additionalProperties": false, "properties": { "attempts": { "description": "Jumlah kumulatif percobaan tugas.", "type": "integer" }, "available_at": { "description": "Waktu UTC paling awal tugas dapat dijalankan.", "format": "date-time", "type": "string" }, "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "last_error": { "description": "Kategori kegagalan terbaru; boleh kosong.", "type": "string" }, "month": { "description": "Bulan UTC YYYY-MM; nilai kueri yang dihilangkan menggunakan bulan saat ini. Job penagihan memerlukan bulan yang telah ditutup.", "type": "string" }, "status": { "description": "Status resource saat ini; lihat enum dan catatan operasi.", "enum": [ "pending", "running", "done", "failed" ], "type": "string" } }, "required": [ "id", "month", "status" ], "type": "object" }, "BillingJobList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/BillingJob" }, "type": "array" }, "limit": { "description": "Ukuran halaman, default 25, rentang 1–100.", "type": "integer" }, "offset": { "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "type": "integer" }, "total": { "description": "Total catatan yang cocok, bukan panjang halaman saat ini.", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "BillingNotificationPreference": { "additionalProperties": false, "properties": { "auto_renewal_problem": { "default": true, "type": "boolean" }, "auto_renewal_success": { "default": true, "type": "boolean" }, "expiry_reminder": { "default": true, "type": "boolean" }, "locale": { "enum": [ "zh", "zh-hant", "en", "es", "hi", "ar", "fr", "bn", "pt", "id", "ur" ], "type": "string" }, "purchase_success": { "default": true, "type": "boolean" }, "updated_at": { "format": "date-time", "type": "string" }, "version": { "type": "string" } }, "required": [ "purchase_success", "expiry_reminder", "auto_renewal_success", "auto_renewal_problem", "locale", "version", "updated_at" ], "type": "object" }, "BillingNotificationPreferenceInput": { "additionalProperties": false, "properties": { "auto_renewal_problem": { "default": true, "type": "boolean" }, "auto_renewal_success": { "default": true, "type": "boolean" }, "expected_version": { "description": "Version dari GET; kosong untuk preferensi yang belum disimpan. Nilai usang mengembalikan BILLING_EMAIL_PREFERENCE_CONFLICT.", "type": "string" }, "expiry_reminder": { "default": true, "type": "boolean" }, "locale": { "enum": [ "zh", "zh-hant", "en", "es", "hi", "ar", "fr", "bn", "pt", "id", "ur" ], "type": "string" }, "purchase_success": { "default": true, "type": "boolean" } }, "required": [ "expected_version" ], "type": "object" }, "BillingNotificationPreferencesResult": { "additionalProperties": false, "properties": { "platform": { "$ref": "#/components/schemas/BillingNotificationSettings" }, "preferences": { "$ref": "#/components/schemas/BillingNotificationPreference" }, "recipient": { "format": "email", "type": "string" } }, "required": [ "preferences", "platform", "recipient" ], "type": "object" }, "BillingNotificationSettings": { "additionalProperties": false, "properties": { "auto_renewal_problem": { "default": true, "type": "boolean" }, "auto_renewal_success": { "default": true, "type": "boolean" }, "expiry_reminder": { "default": true, "type": "boolean" }, "purchase_success": { "default": true, "type": "boolean" }, "reminder_days": { "default": [ 7 ], "description": "Ambang sebelum cakupan berkelanjutan berakhir, dalam hari 24 jam. Disimpan dalam urutan naik. Worker yang terlambat mulai hanya memilih ambang tersisa terdekat, bukan setiap pengingat yang terlewat.", "items": { "maximum": 90, "minimum": 1, "type": "integer" }, "maxItems": 10, "minItems": 1, "type": "array", "uniqueItems": true }, "support_email": { "description": "Email dukungan publik dan Reply-To untuk email penagihan. Kosong menyembunyikan kontak. Tidak mengubah alamat SMTP From yang ada atau membuat kotak masuk.", "maxLength": 254, "type": "string" }, "version": { "type": "string" } }, "required": [ "purchase_success", "expiry_reminder", "auto_renewal_success", "auto_renewal_problem", "reminder_days", "support_email", "version" ], "type": "object" }, "BillingNotificationSettingsInput": { "additionalProperties": false, "properties": { "auto_renewal_problem": { "default": true, "type": "boolean" }, "auto_renewal_success": { "default": true, "type": "boolean" }, "expected_version": { "description": "Version dari GET. Nilai usang mengembalikan BILLING_EMAIL_SETTINGS_CONFLICT.", "type": "string" }, "expiry_reminder": { "default": true, "type": "boolean" }, "purchase_success": { "default": true, "type": "boolean" }, "reminder_days": { "default": [ 7 ], "description": "Ambang sebelum cakupan berkelanjutan berakhir, dalam hari 24 jam. Disimpan dalam urutan naik. Worker yang terlambat mulai hanya memilih ambang tersisa terdekat, bukan setiap pengingat yang terlewat.", "items": { "maximum": 90, "minimum": 1, "type": "integer" }, "maxItems": 10, "minItems": 1, "type": "array", "uniqueItems": true }, "support_email": { "description": "Email dukungan publik dan Reply-To untuk email penagihan. Kosong menyembunyikan kontak. Tidak mengubah alamat SMTP From yang ada atau membuat kotak masuk.", "maxLength": 254, "type": "string" } }, "required": [ "expected_version" ], "type": "object" }, "BundleInput": { "additionalProperties": false, "properties": { "language": { "description": "Pengenal bahasa SDK untuk bundel unduhan.", "enum": [ "go", "java", "c", "cpp", "csharp", "python", "javascript", "rust", "ruby" ], "type": "string" } }, "required": [ "language" ], "type": "object" }, "BuyPlan": { "additionalProperties": false, "properties": { "currency": { "pattern": "^[A-Z]{3}$", "type": "string" }, "overage_accepted": { "description": "Otorisasi eksplisit terpisah untuk kelebihan penggunaan berbayar yang ditampilkan.", "type": "boolean" }, "plan": { "pattern": "^[a-z][a-z0-9_-]{0,63}$", "type": "string" }, "policy_version": { "description": "Versi kebijakan tidak berubah yang saat ini diterbitkan. Wajib untuk tindakan yang dilindungi persetujuan setelah operator menerbitkan kebijakan, pada kedua lingkungan pembayaran.", "type": "string" }, "price_version": { "type": "string" }, "renewal": { "default": false, "description": "Perpanjangan di muka secara eksplisit. Pembayaran dikumpulkan sekarang dan cakupan prabayar segera diperpanjang. Siklus kuota berikutnya mengikuti cakupan berbayar atau hadiah yang ada. Penggunaan saat ini tidak direset. Perpanjang paket dan mata uang berbayar terbaru; pelanggan yang kedaluwarsa juga dapat membeli secara normal.", "type": "boolean" }, "request_id": { "maxLength": 80, "type": "string" }, "term_months": { "default": 1, "description": "Durasi kontrak. Jika dihilangkan default satu bulan. Mengubah durasi pada request_id yang digunakan kembali mengembalikan 409.", "enum": [ 1, 3, 6, 12 ], "type": "integer" }, "terms_accepted": { "description": "Persetujuan eksplisit yang secara default tidak dicentang.", "type": "boolean" } }, "required": [ "plan", "currency", "price_version", "request_id" ], "type": "object" }, "CSRF": { "additionalProperties": false, "properties": { "csrf_token": { "type": "string" } }, "required": [ "csrf_token" ], "type": "object" }, "CancelCustomerRefund": { "additionalProperties": false, "properties": { "confirm_service_stays_cancelled": { "description": "Wajib ketika pembatalan layanan sudah dilaksanakan sebelum peninjauan. Permohonan tertunda bercakupan eksplisit dapat ditarik tanpa menghentikan atau memulihkan layanan.", "type": "boolean" } }, "type": "object" }, "ChangePassword": { "additionalProperties": false, "properties": { "current_password": { "description": "12–128 byte UTF-8, bukan karakter", "type": "string", "writeOnly": true }, "password": { "description": "12–128 byte UTF-8, bukan karakter", "type": "string", "writeOnly": true }, "password_confirmation": { "description": "Wajib dan harus sama persis dengan kata sandi", "type": "string", "writeOnly": true } }, "required": [ "current_password", "password", "password_confirmation" ], "type": "object" }, "ClosureExportCredential": { "additionalProperties": false, "properties": { "download_url": { "type": "string" }, "expires_at": { "format": "date-time", "type": "string" }, "export_deadline": { "format": "date-time", "type": "string" } }, "required": [], "type": "object" }, "ClosureExportLogin": { "additionalProperties": false, "properties": { "current_password": { "type": "string" }, "email": { "format": "email", "type": "string" } }, "required": [ "email", "current_password" ], "type": "object" }, "CommerceNotice": { "additionalProperties": false, "properties": { "body": { "description": "Isi pemberitahuan layanan.", "type": "string" }, "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "effective_at": { "anyOf": [ { "description": "Waktu berlakunya perubahan yang diberitahukan, atau null.", "format": "date-time", "type": "string" }, { "description": "Waktu berlakunya perubahan yang diberitahukan, atau null.", "type": "null" } ], "description": "Waktu berlakunya perubahan yang diberitahukan, atau null." }, "emailed_at": { "anyOf": [ { "description": "Stempel waktu pengiriman email pemberitahuan, atau null.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu pengiriman email pemberitahuan, atau null.", "type": "null" } ], "description": "Stempel waktu pengiriman email pemberitahuan, atau null." }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "kind": { "description": "Pengenal kategori entri ledger atau pemberitahuan.", "type": "string" }, "read_at": { "anyOf": [ { "description": "Stempel waktu pembacaan pemberitahuan, atau null.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu pembacaan pemberitahuan, atau null.", "type": "null" } ], "description": "Stempel waktu pembacaan pemberitahuan, atau null." }, "reference": { "description": "Referensi bisnis terkait yang digunakan untuk pelacakan.", "type": "string" }, "title": { "description": "Judul pemberitahuan layanan.", "type": "string" } }, "required": [], "type": "object" }, "CommerceNoticeList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/CommerceNotice" }, "type": "array" } }, "required": [ "items" ], "type": "object" }, "CommercePolicy": { "additionalProperties": false, "properties": { "documents": { "properties": { "privacy": { "type": "string" }, "refunds": { "type": "string" }, "terms": { "type": "string" } }, "type": "object" }, "locale": { "type": "string" }, "pending": { "items": { "additionalProperties": false, "properties": { "created_at": { "format": "date-time", "type": "string" }, "effective_at": { "format": "date-time", "type": "string" }, "version": { "type": "string" } }, "required": [], "type": "object" }, "type": "array" }, "profile": { "$ref": "#/components/schemas/OperatorProfile" }, "published": { "type": "boolean" }, "ready": { "type": "boolean" }, "version": { "type": "string" } }, "required": [], "type": "object" }, "CommercePolicyInput": { "additionalProperties": false, "properties": { "expected_version": { "type": "string" }, "profile": { "$ref": "#/components/schemas/OperatorProfile" }, "published": { "type": "boolean" } }, "required": [ "profile", "published", "expected_version" ], "type": "object" }, "CommerceResult": { "additionalProperties": true, "type": "object" }, "Confirmation": { "additionalProperties": false, "properties": { "confirm": { "const": true, "type": "boolean" } }, "required": [ "confirm" ], "type": "object" }, "Consumption": { "additionalProperties": false, "properties": { "feature": { "description": "Pengenal fitur yang dikonsumsi.", "type": "string" }, "limit": { "description": "Batas penggunaan fitur untuk periode kuota ini.", "type": "integer" }, "overage": { "description": "Unit di atas batas pada periode ini, bukan uang. Kebijakan mengendalikan batas kelebihan fitur.", "type": "integer" }, "period": { "description": "Periode pengukuran: YYYY-MM untuk bulanan, YYYY-MM-DD untuk harian, lifetime untuk total. Batas harian/bulanan menggunakan UTC.", "type": "string" }, "quantity": { "description": "Unit yang diminta untuk operasi ini, bilangan bulat 1–1000000000.", "type": "integer" }, "remaining": { "description": "remaining = max(0, limit - used - reserved), tidak termasuk unit kelebihan.", "type": "integer" }, "reserved": { "description": "Unit yang dicadangkan dan belum kedaluwarsa pada periode ini, belum ditagih.", "type": "integer" }, "reset_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "description": "Reset berikutnya, UTC ISO 8601; null untuk pengukuran lifetime." }, "used": { "description": "Unit yang dikomit pada periode ini, tidak termasuk reservasi.", "type": "integer" } }, "required": [], "type": "object" }, "ConsumptionResult": { "additionalProperties": false, "properties": { "activation_id": { "description": "UUID pengikatan perangkat atau sesi runtime. Simpan untuk permintaan lisensi berikutnya; bukan kunci lisensi.", "format": "uuid", "type": "string" }, "consumption": { "$ref": "#/components/schemas/Consumption" }, "heartbeat_seconds": { "anyOf": [ { "const": 0 }, { "maximum": 86400, "minimum": 600, "type": "integer" } ], "description": "Interval heartbeat saat ini dalam detik; pengukuran tidak memperbarui tanda tangan atau pengatur waktu.", "type": "integer" } }, "required": [ "activation_id", "consumption" ], "type": "object" }, "CustomerAssignment": { "additionalProperties": false, "properties": { "email": { "description": "Kosong menghapus tautan portal", "type": "string" }, "name": { "description": "Nama yang dapat dibaca manusia; lihat batas panjang.", "maxLength": 120, "type": "string" } }, "required": [ "email" ], "type": "object" }, "CustomerControlsInput": { "additionalProperties": false, "anyOf": [ { "required": [ "device_enabled" ] }, { "required": [ "api_enabled" ] } ], "properties": { "api_enabled": { "type": "boolean" }, "device_enabled": { "type": "boolean" } }, "required": [], "type": "object" }, "CustomerControlsResult": { "additionalProperties": false, "properties": { "api_enabled": { "type": "boolean" }, "device_enabled": { "type": "boolean" } }, "required": [ "device_enabled", "api_enabled" ], "type": "object" }, "CustomerDataExportInput": { "additionalProperties": false, "properties": { "current_password": { "type": "string" }, "reason": { "maxLength": 500, "type": "string" }, "scope": { "enum": [ "account", "workspace" ], "type": "string" } }, "required": [ "scope", "current_password", "reason" ], "type": "object" }, "CustomerLicenses": { "additionalProperties": false, "properties": { "email": { "type": "string" }, "items": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" } }, "required": [ "email", "items" ], "type": "object" }, "CustomerOverageConsent": { "additionalProperties": false, "properties": { "overage_accepted": { "description": "Otorisasi eksplisit terpisah untuk kelebihan penggunaan berbayar yang ditampilkan.", "type": "boolean" }, "policy_version": { "description": "Versi kebijakan tidak berubah yang saat ini diterbitkan. Wajib untuk tindakan yang dilindungi persetujuan setelah operator menerbitkan kebijakan, pada kedua lingkungan pembayaran.", "type": "string" }, "price_version": { "type": "string" }, "terms_accepted": { "description": "Persetujuan eksplisit yang secara default tidak dicentang.", "type": "boolean" } }, "required": [ "price_version", "policy_version", "terms_accepted", "overage_accepted" ], "type": "object" }, "CustomerRefundInput": { "additionalProperties": false, "properties": { "amount": { "type": "string" }, "change_id": { "type": "string" }, "confirm_termination": { "type": "boolean" }, "incident_id": { "type": "string" }, "message": { "type": "string" }, "order_id": { "type": "string" }, "purchase_id": { "type": "string" }, "quote_hash": { "type": "string" }, "quoted_at": { "format": "date-time", "type": "string" }, "reason": { "enum": [ "customer_request", "future", "wallet", "usage_change", "platform_failure", "statutory", "billing_error", "failed_delivery" ], "type": "string" }, "request_id": { "type": "string" }, "scope": { "description": "Cakupan eksplisit menggunakan pembatalan saat persetujuan; penghilangan mengizinkan pembatalan segera yang memenuhi syarat setelah konfirmasi eksplisit.", "enum": [ "purchase", "service" ], "type": "string" } }, "required": [ "reason", "message", "request_id" ], "type": "object" }, "CustomerRefundQuote": { "anyOf": [ { "$ref": "#/components/schemas/RefundQuote" }, { "$ref": "#/components/schemas/ScopedRefundPreview" } ] }, "CustomerRefundQuoteInput": { "additionalProperties": false, "properties": { "amount": { "type": "string" }, "change_id": { "type": "string" }, "confirm_termination": { "type": "boolean" }, "incident_id": { "type": "string" }, "message": { "type": "string" }, "order_id": { "type": "string" }, "purchase_id": { "type": "string" }, "quote_hash": { "type": "string" }, "quoted_at": { "format": "date-time", "type": "string" }, "reason": { "enum": [ "customer_request", "future", "wallet", "usage_change", "platform_failure", "statutory", "billing_error", "failed_delivery" ], "type": "string" }, "request_id": { "type": "string" }, "scope": { "description": "Cakupan eksplisit menggunakan pembatalan saat persetujuan; penghilangan mengizinkan pembatalan segera yang memenuhi syarat setelah konfirmasi eksplisit.", "enum": [ "purchase", "service" ], "type": "string" } }, "required": [ "reason", "message" ], "type": "object" }, "CustomerReleaseInput": { "additionalProperties": false, "description": "Konfirmasi pelepasan sebelum mengirim. send_email secara opsional mengantrekan kode sementara ke alamat pelanggan yang terverifikasi; generation melindungi dari tampilan perangkat yang usang.", "properties": { "generation": { "minimum": 1, "type": "integer" }, "send_email": { "type": "boolean" } }, "required": [], "type": "object" }, "CustomerReleaseResult": { "additionalProperties": false, "properties": { "email_queued": { "type": "boolean" }, "id": { "format": "uuid", "type": "string" }, "status": { "const": "released", "type": "string" }, "transfer": { "anyOf": [ { "$ref": "#/components/schemas/TransferCode" }, { "type": "null" } ] } }, "required": [ "id", "status", "transfer", "email_queued" ], "type": "object" }, "CustomerSession": { "additionalProperties": false, "properties": { "email": { "format": "email", "type": "string" } }, "required": [], "type": "object" }, "DatabaseStatus": { "additionalProperties": false, "properties": { "connected": { "type": "boolean" }, "database": { "type": "string" }, "host": { "type": "string" }, "open_connections": { "type": "integer" }, "version": { "type": "string" } }, "required": [ "connected", "host", "database" ], "type": "object" }, "DefaultPlan": { "additionalProperties": false, "properties": { "allow_customer_api_overage": { "default": false, "description": "Hanya mengizinkan pilihan kelebihan API pelanggan. Independen dari izin perangkat. Ketika false, penggunaan API mengikuti aturan administrator. API tak terbatas tetap tidak terbatas.", "type": "boolean" }, "allow_customer_device_overage": { "default": false, "description": "Hanya mengizinkan pilihan kelebihan perangkat pelanggan. Ketika false, penggunaan perangkat mengikuti aturan administrator dan pilihan perangkat pelanggan yang tersimpan diabaikan hingga diaktifkan kembali.", "type": "boolean" }, "default_currency": { "pattern": "^[A-Z]{3}$", "type": "string" }, "default_plan": { "pattern": "^[a-z][a-z0-9_-]{0,63}$", "type": "string" } }, "required": [ "default_plan", "default_currency" ], "type": "object" }, "DeliveryList": { "additionalProperties": false, "properties": { "items": { "anyOf": [ { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/WebhookDelivery" }, "type": "array" }, { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "type": "null" } ], "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type." }, "limit": { "description": "Ukuran halaman, default 25, rentang 1–100.", "type": "integer" }, "offset": { "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "type": "integer" }, "total": { "description": "Total catatan yang cocok, bukan panjang halaman saat ini.", "type": "integer" } }, "required": [], "type": "object" }, "DeviceProfile": { "additionalProperties": false, "properties": { "hardware_id": { "description": "SHA-256 dari identitas produk dan perangkat keras. Kosong jika tidak tersedia; kebijakan yang memerlukan perangkat keras akan menolaknya.", "type": "string" }, "platform": { "description": "OS lokal: windows, linux atau darwin (macOS).", "enum": [ "windows", "linux", "darwin" ], "type": "string" }, "system_id": { "description": "SHA-256 dari identitas produk dan sistem: 64 karakter heksadesimal huruf kecil.", "pattern": "^[0-9a-f]{64}$", "type": "string" }, "version": { "const": 3, "description": "Versi protokol sidik jari perangkat, saat ini 3.", "type": "integer" }, "virtual_machine": { "description": "Boolean: apakah SDK mendeteksi mesin virtual.", "type": "boolean" } }, "required": [ "version", "system_id", "hardware_id", "virtual_machine", "platform" ], "type": "object" }, "DeviceReleaseOperation": { "additionalProperties": false, "properties": { "activation_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "attempts": { "description": "Jumlah percobaan pemrosesan gagal yang dipertahankan oleh Licentivo.", "type": "integer" }, "available_at": { "description": "Waktu pembuatan catatan dalam UTC.", "format": "date-time", "type": "string" }, "completed_at": { "anyOf": [ { "description": "Waktu pembuatan catatan dalam UTC.", "format": "date-time", "type": "string" }, { "description": "Waktu operasi selesai; dihilangkan selama tertunda.", "type": "null" } ], "description": "Waktu operasi selesai; dihilangkan selama tertunda." }, "connection_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "created_at": { "description": "Waktu pembuatan catatan dalam UTC.", "format": "date-time", "type": "string" }, "error_code": { "description": "Alasan pemrosesan atau peninjauan yang stabil; kosong setelah berhasil.", "type": "string" }, "expected_generation": { "description": "Generasi pengikatan perangkat yang diharapkan, dibandingkan di dalam transaksi pencabutan.", "minimum": 1, "type": "integer" }, "license_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "operation_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "source": { "description": "Asal operasi pencabutan ini.", "enum": [ "logout", "launch", "admin" ], "type": "string" }, "status": { "description": "Siklus hidup atau status pemrosesan saat ini yang dimiliki server.", "enum": [ "pending", "succeeded", "stale", "manual_review" ], "type": "string" } }, "required": [ "operation_id", "license_id", "activation_id", "expected_generation", "source", "status" ], "type": "object" }, "EligibleReleases": { "additionalProperties": false, "properties": { "authorization": { "additionalProperties": true, "type": "object" }, "items": { "items": { "$ref": "#/components/schemas/Release" }, "type": "array" } }, "required": [], "type": "object" }, "Email": { "additionalProperties": false, "properties": { "email": { "format": "email", "type": "string" } }, "required": [ "email" ], "type": "object" }, "EmailChangeConfirmation": { "additionalProperties": false, "properties": { "token": { "maxLength": 2048, "minLength": 32, "type": "string" } }, "required": [ "token" ], "type": "object" }, "Empty": { "additionalProperties": false, "properties": {}, "required": [], "type": "object" }, "EmptyRefundPreviewInput": { "additionalProperties": false, "properties": {}, "required": [], "type": "object" }, "Error": { "additionalProperties": false, "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "properties": { "error": { "additionalProperties": false, "description": "Objek kesalahan atau kategori kegagalan pengiriman; lihat bidang turunan atau jenis saat ini.", "properties": { "code": { "description": "Kode kesalahan stabil yang dapat dibaca mesin.", "type": "string" }, "message": { "description": "Pesan kesalahan yang dapat dibaca manusia; gunakan kode untuk percabangan.", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "request_id": { "description": "UUID permintaan HTTP yang dibuat server untuk pencarian log; bukan ID lisensi atau ID idempotensi.", "format": "uuid", "type": "string" } }, "required": [ "error", "request_id" ], "type": "object" }, "FeatureReservation": { "additionalProperties": false, "properties": { "consumption": { "$ref": "#/components/schemas/Consumption", "description": "Tanda terima penggunaan: unit yang dikurangi, penggunaan kumulatif, sisa jatah, dan reset berikutnya." }, "expires_at": { "description": "Tenggat reservasi dalam UTC; lakukan commit sebelum waktu ini.", "format": "date-time", "type": "string" }, "operation_id": { "description": "ID job asli yang digunakan untuk reservasi; pertahankan untuk percobaan ulang.", "type": "string" }, "reservation_id": { "description": "ID reservasi; kirim nilai ini untuk commit atau cancel.", "format": "uuid", "type": "string" }, "status": { "description": "pending: lakukan operasi; committed: ditagih; canceled dan expired: ditutup tanpa biaya.", "enum": [ "pending", "committed", "canceled", "expired" ], "type": "string" } }, "required": [ "reservation_id", "operation_id", "status", "expires_at", "consumption" ], "type": "object" }, "FeatureUsage": { "additionalProperties": false, "properties": { "feature": { "description": "Pengenal fitur terukur, yang harus ada dalam fitur kebijakan.", "type": "string" }, "license_id": { "description": "UUID lisensi, berbeda dari rahasia lv_lic_.", "format": "uuid", "type": "string" }, "period": { "description": "Snapshot penagihan bulanan UTC default; aturan meter menggunakan month/day/lifetime dan baris penggunaan menggunakan kunci periode konkret.", "type": "string" }, "quantity": { "description": "Jumlah kumulatif yang digunakan untuk fitur dan periode ini.", "type": "integer" }, "updated_at": { "description": "Stempel waktu pembaruan terakhir dalam UTC.", "format": "date-time", "type": "string" } }, "required": [ "license_id", "feature", "period", "quantity", "updated_at" ], "type": "object" }, "ForumAuthor": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name" ], "type": "object" }, "ForumImage": { "additionalProperties": false, "properties": { "height": { "type": "integer" }, "id": { "format": "uuid", "type": "string" }, "size": { "type": "integer" }, "url": { "type": "string" }, "width": { "type": "integer" } }, "required": [ "id", "url", "width", "height", "size" ], "type": "object" }, "ForumModerationInput": { "additionalProperties": false, "description": "Memerlukan sesi browser admin platform. Berikan setidaknya satu bidang; bidang yang dihilangkan mempertahankan nilai saat ini. Penyematan berlaku untuk topik yang diterbitkan atau tersembunyi dan tidak memulihkan konten yang dihapus.", "minProperties": 1, "properties": { "hidden": { "type": "boolean" }, "locked": { "type": "boolean" }, "pinned": { "type": "boolean" } }, "required": [], "type": "object" }, "ForumReply": { "additionalProperties": false, "properties": { "author": { "$ref": "#/components/schemas/ForumAuthor" }, "body": { "type": "string" }, "can_delete": { "type": "boolean" }, "can_edit": { "type": "boolean" }, "created_at": { "format": "date-time", "type": "string" }, "id": { "format": "uuid", "type": "string" }, "images": { "items": { "$ref": "#/components/schemas/ForumImage" }, "type": "array" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "id", "body", "author", "images", "created_at", "updated_at", "can_edit", "can_delete" ], "type": "object" }, "ForumReplyInput": { "additionalProperties": false, "properties": { "body": { "maxLength": 12000, "minLength": 1, "type": "string" }, "image_ids": { "items": { "format": "uuid", "type": "string" }, "maxItems": 6, "type": "array", "uniqueItems": true } }, "required": [ "body" ], "type": "object" }, "ForumTopic": { "additionalProperties": false, "properties": { "author": { "$ref": "#/components/schemas/ForumAuthor" }, "body": { "type": "string" }, "can_delete": { "type": "boolean" }, "can_edit": { "type": "boolean" }, "can_moderate": { "type": "boolean" }, "category": { "enum": [ "integration", "help", "ideas", "showcase" ], "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "id": { "format": "uuid", "type": "string" }, "images": { "items": { "$ref": "#/components/schemas/ForumImage" }, "type": "array" }, "language": { "enum": [ "en", "zh", "zh-hant", "hi", "es", "ar", "fr", "bn", "pt", "id", "ur" ], "type": "string" }, "last_reply_at": { "format": "date-time", "type": "string" }, "locked": { "type": "boolean" }, "pinned": { "type": "boolean" }, "reply_count": { "type": "integer" }, "title": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "id", "title", "body", "category", "language", "locked", "pinned", "author", "images", "reply_count", "created_at", "updated_at", "last_reply_at", "can_edit", "can_delete", "can_moderate" ], "type": "object" }, "ForumTopicDetail": { "additionalProperties": false, "properties": { "limit": { "type": "integer" }, "offset": { "type": "integer" }, "replies": { "items": { "$ref": "#/components/schemas/ForumReply" }, "type": "array" }, "topic": { "$ref": "#/components/schemas/ForumTopic" }, "total": { "type": "integer" } }, "required": [ "topic", "replies", "total", "limit", "offset" ], "type": "object" }, "ForumTopicInput": { "additionalProperties": false, "properties": { "body": { "maxLength": 12000, "minLength": 1, "type": "string" }, "category": { "enum": [ "integration", "help", "ideas", "showcase" ], "type": "string" }, "image_ids": { "items": { "format": "uuid", "type": "string" }, "maxItems": 6, "type": "array", "uniqueItems": true }, "language": { "enum": [ "en", "zh", "zh-hant", "hi", "es", "ar", "fr", "bn", "pt", "id", "ur" ], "type": "string" }, "title": { "maxLength": 180, "minLength": 2, "type": "string" } }, "required": [ "title", "body", "category", "language" ], "type": "object" }, "ForumTopicList": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/ForumTopic" }, "type": "array" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "total": { "type": "integer" } }, "required": [ "items", "total", "limit", "offset" ], "type": "object" }, "ForumTranslationInput": { "additionalProperties": false, "properties": { "reply_id": { "format": "uuid", "type": "string" }, "target_language": { "description": "Pilih bahasa yang dikembalikan oleh GET /forum/translation.", "type": "string" } }, "required": [ "target_language" ], "type": "object" }, "ForumTranslationResult": { "additionalProperties": false, "properties": { "body": { "description": "Teks biasa hasil terjemahan. Render dengan textContent, jangan sebagai HTML.", "type": "string" }, "cached": { "type": "boolean" }, "provider": { "type": "string" }, "source_language": { "description": "Bahasa sumber terdeteksi yang dilaporkan DeepL.", "type": "string" }, "target_language": { "description": "Bahasa target penyedia yang dipilih.", "type": "string" }, "title": { "description": "Judul topik terjemahan; kosong untuk balasan.", "type": "string" } }, "required": [ "title", "body", "source_language", "target_language", "cached", "provider" ], "type": "object" }, "Health": { "additionalProperties": false, "properties": { "status": { "enum": [ "ok", "ready" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, "ID": { "additionalProperties": false, "properties": { "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } }, "required": [ "id" ], "type": "object" }, "Invite": { "additionalProperties": false, "properties": { "email": { "format": "email", "type": "string" }, "name": { "maxLength": 120, "minLength": 1, "type": "string" }, "role": { "enum": [ "owner", "read_only" ], "type": "string" } }, "required": [ "email", "name", "role" ], "type": "object" }, "Invited": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "type": "string" }, "message": { "type": "string" } }, "required": [ "id", "message" ], "type": "object" }, "Invoice": { "additionalProperties": false, "properties": { "active_devices": { "description": "Jumlah perangkat yang dibekukan untuk penagihan dari puncak hunian periode default. Ini bukan hunian saat ini maupun daftar penggunaan perangkat kumulatif.", "type": "integer" }, "base_covered": { "description": "Apakah paket yang dibeli sudah mencakup biaya dasar.", "type": "boolean" }, "base_micros": { "description": "Biaya dasar dalam sepersejuta unit mata uang.", "type": "integer" }, "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "currency": { "description": "Kode mata uang huruf besar tiga huruf, seperti USD.", "pattern": "^[A-Z]{3}$", "type": "string" }, "finalized_at": { "anyOf": [ { "description": "Stempel waktu finalisasi faktur, atau null.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu finalisasi faktur, atau null.", "type": "null" } ], "description": "Stempel waktu finalisasi faktur, atau null." }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "included_devices": { "description": "Jatah perangkat aktif yang disertakan.", "type": "integer" }, "month": { "description": "Bulan UTC YYYY-MM; nilai kueri yang dihilangkan menggunakan bulan saat ini. Job penagihan memerlukan bulan yang telah ditutup.", "type": "string" }, "overage_devices": { "description": "Perangkat yang melebihi jatah yang disertakan.", "type": "integer" }, "paid_at": { "anyOf": [ { "description": "Stempel waktu pembayaran faktur, atau null.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu pembayaran faktur, atau null.", "type": "null" } ], "description": "Stempel waktu pembayaran faktur, atau null." }, "payment_mode": { "description": "Lingkungan pembayaran, sandbox atau live.", "enum": [ "sandbox", "live" ], "type": "string" }, "plan": { "description": "Pengenal paket penagihan stabil dari katalog yang diterbitkan.", "type": "string" }, "plan_name": { "description": "Nama tampilan paket.", "type": "string" }, "price_version": { "description": "Revisi harga yang dibekukan; input usang dapat menyebabkan PLAN_VERSION_CONFLICT.", "type": "string" }, "refunded_at": { "anyOf": [ { "description": "Stempel waktu pengembalian dana faktur, atau null.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu pengembalian dana faktur, atau null.", "type": "null" } ], "description": "Stempel waktu pengembalian dana faktur, atau null." }, "status": { "description": "Status resource saat ini; lihat enum dan catatan operasi.", "enum": [ "draft", "finalized", "void" ], "type": "string" }, "total_cents": { "description": "Total faktur dalam seperseratus; lihat paid_at untuk status pembayaran.", "type": "integer" }, "total_micros": { "description": "Total faktur dalam sepersejuta unit mata uang.", "type": "integer" }, "unit_micros": { "description": "Harga per kelebihan perangkat aktif dalam sepersejuta.", "type": "integer" }, "voided_at": { "anyOf": [ { "description": "Stempel waktu pembatalan faktur, atau null.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu pembatalan faktur, atau null.", "type": "null" } ], "description": "Stempel waktu pembatalan faktur, atau null." } }, "required": [ "id", "month", "currency", "status", "total_cents" ], "type": "object" }, "InvoiceList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/Invoice" }, "type": "array" }, "limit": { "description": "Ukuran halaman, default 25, rentang 1–100.", "type": "integer" }, "offset": { "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "type": "integer" }, "total": { "description": "Total catatan yang cocok, bukan panjang halaman saat ini.", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "Key": { "additionalProperties": false, "properties": { "allow_http": { "description": "Izinkan kunci ini mendaftarkan atau memperbarui origin situs HTTP Launch, termasuk domain server uji, alamat IP privat, dan hostname internal. Permintaan API Licentivo tetap menggunakan HTTPS.", "type": "boolean" }, "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "expires_at": { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "format": "date-time", "type": "string" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "name": { "description": "Nama yang dapat dibaca manusia; lihat batas panjang.", "type": "string" }, "prefix": { "description": "14 karakter pertama kunci manajemen; hanya untuk identifikasi.", "type": "string" }, "revoked": { "description": "Apakah dicabut; periksa juga expires_at untuk kedaluwarsa.", "type": "boolean" }, "scope": { "description": "read mengizinkan pembacaan; write mengizinkan pembacaan dan penulisan. Penulisan juga memerlukan pembuat Owner yang aktif.", "enum": [ "read", "write" ], "type": "string" } }, "required": [ "id", "prefix", "scope", "revoked", "allow_http" ], "type": "object" }, "KeyBundle": { "additionalProperties": false, "properties": { "keys": { "items": { "$ref": "#/components/schemas/SigningKey" }, "type": "array" }, "product_id": { "format": "uuid", "type": "string" }, "protocol": { "type": "string" }, "runtime_policy_source": { "const": "current_license_policy", "type": "string" } }, "required": [ "product_id", "keys" ], "type": "object" }, "KeyCreate": { "additionalProperties": false, "properties": { "allow_http": { "default": false, "description": "Izinkan kunci ini mendaftarkan atau memperbarui origin situs HTTP Launch, termasuk domain server uji, alamat IP privat, dan hostname internal. Permintaan API Licentivo tetap menggunakan HTTPS.", "type": "boolean" }, "expires_days": { "description": "Hari dari pembuatan sampai kedaluwarsa, 1–365.", "maximum": 365, "minimum": 1, "type": "integer" }, "name": { "description": "Nama yang dapat dibaca manusia; lihat batas panjang.", "maxLength": 120, "minLength": 1, "type": "string" }, "scope": { "description": "read mengizinkan pembacaan; write mengizinkan pembacaan dan penulisan. Penulisan juga memerlukan pembuat Owner yang aktif.", "enum": [ "read", "write" ], "type": "string" } }, "required": [ "name", "scope", "expires_days" ], "type": "object" }, "KeyList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/Key" }, "type": "array" }, "limit": { "description": "Ukuran halaman, default 25, rentang 1–100.", "type": "integer" }, "offset": { "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "type": "integer" }, "total": { "description": "Total catatan yang cocok, bukan panjang halaman saat ini.", "type": "integer" } }, "required": [ "items" ], "type": "object" }, "KeyRotated": { "additionalProperties": false, "example": { "id": "33333333-3333-4333-8333-333333333333", "key": "lv_api_BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB", "prefix": "lv_api_BBBBBBB" }, "properties": { "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "key": { "description": "Full secret returned on creation or rotation. Owners may also view saved license keys on demand in a browser session. Store privately; the prefix cannot authenticate.", "type": "string" }, "prefix": { "description": "14 karakter pertama kunci manajemen; hanya untuk identifikasi.", "type": "string" } }, "required": [ "id", "key", "prefix" ], "type": "object" }, "KeySecret": { "additionalProperties": false, "example": { "expires_at": "2027-01-16T00:00:00Z", "id": "33333333-3333-4333-8333-333333333333", "key": "lv_api_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "prefix": "lv_api_AAAAAAA" }, "properties": { "allow_http": { "description": "Izinkan kunci ini mendaftarkan atau memperbarui origin situs HTTP Launch, termasuk domain server uji, alamat IP privat, dan hostname internal. Permintaan API Licentivo tetap menggunakan HTTPS.", "type": "boolean" }, "expires_at": { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "format": "date-time", "type": "string" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "key": { "description": "Hanya ditampilkan saat pembuatan/rotasi", "type": "string" }, "prefix": { "description": "14 karakter pertama kunci manajemen; hanya untuk identifikasi.", "type": "string" } }, "required": [ "id", "key", "prefix" ], "type": "object" }, "KeyUpdate": { "additionalProperties": false, "properties": { "allow_http": { "description": "Izinkan kunci ini mendaftarkan atau memperbarui origin situs HTTP Launch, termasuk domain server uji, alamat IP privat, dan hostname internal. Permintaan API Licentivo tetap menggunakan HTTPS.", "type": "boolean" } }, "required": [ "allow_http" ], "type": "object" }, "KeyUpdated": { "additionalProperties": false, "properties": { "allow_http": { "description": "Izinkan kunci ini mendaftarkan atau memperbarui origin situs HTTP Launch, termasuk domain server uji, alamat IP privat, dan hostname internal. Permintaan API Licentivo tetap menggunakan HTTPS.", "type": "boolean" }, "id": { "description": "Unique record identifier.", "format": "uuid", "type": "string" } }, "required": [ "id", "allow_http" ], "type": "object" }, "LaunchCommerceEvent": { "additionalProperties": false, "properties": { "account_ref": { "description": "Referensi hak pembelian yang tidak dapat diubah dan peka huruf besar/kecil.", "pattern": "^[A-Za-z0-9_-]{1,128}$", "type": "string" }, "entitlement_ref": { "description": "Referensi hak pembelian yang tidak dapat diubah dan peka huruf besar/kecil.", "pattern": "^[A-Za-z0-9_-]{1,128}$", "type": "string" }, "environment": { "description": "Lingkungan perdagangan, dipatok pada koneksi dan grant bertanda tangan.", "enum": [ "live", "sandbox" ], "type": "string" }, "event_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "launch_product_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "legacy_license_id": { "description": "Hanya untuk entitlement.migrated. Lisensi, kedaluwarsa, kemampuan, dan catatan perangkat yang ada dipertahankan; kunci lama dan kredensial perangkat kehilangan akses runtime.", "format": "uuid", "type": "string" }, "plan_ref": { "description": "Referensi hak pembelian yang tidak dapat diubah dan peka huruf besar/kecil.", "pattern": "^[A-Za-z0-9_-]{1,128}$", "type": "string" }, "type": { "description": "Jenis peristiwa perdagangan snapshot lengkap berversi.", "enum": [ "entitlement.created", "entitlement.renewed", "entitlement.upgraded", "entitlement.downgraded", "entitlement.refunded", "entitlement.suspended", "entitlement.expired", "entitlement.resumed", "entitlement.migrated" ], "type": "string" }, "valid_from": { "description": "Waktu pembuatan catatan dalam UTC.", "format": "date-time", "type": "string" }, "valid_until": { "anyOf": [ { "description": "Waktu pembuatan catatan dalam UTC.", "format": "date-time", "type": "string" }, { "description": "Kedaluwarsa absolut pembelian, UTC; null hanya untuk kebijakan perpetual.", "type": "null" } ], "description": "Kedaluwarsa absolut pembelian, UTC; null hanya untuk kebijakan perpetual." }, "version": { "description": "Versi snapshot lengkap yang meningkat secara monoton untuk referensi hak ini, bukan nomor percobaan pengiriman.", "minimum": 1, "type": "integer" } }, "required": [ "event_id", "environment", "type", "entitlement_ref", "account_ref", "launch_product_id", "plan_ref", "version", "valid_from" ], "type": "object" }, "LaunchConnection": { "additionalProperties": false, "properties": { "audience": { "description": "Penerima yang tepat dan dituju oleh assertion login Launch.", "type": "string" }, "created_at": { "description": "Waktu pembuatan catatan dalam UTC.", "format": "date-time", "type": "string" }, "enabled": { "description": "Apakah koneksi kepercayaan ini dapat mengotorisasi penggunaan runtime baru.", "type": "boolean" }, "environment": { "description": "Lingkungan perdagangan, dipatok pada koneksi dan grant bertanda tangan.", "enum": [ "live", "sandbox" ], "type": "string" }, "heartbeat_seconds": { "description": "Interval verifikasi online yang dipilih server dalam detik.", "type": "integer" }, "id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "issuer": { "description": "Origin Launch tepercaya yang tepat.", "type": "string" }, "offline_seconds": { "description": "Interval offline terbatas yang diizinkan dalam detik; nol mewajibkan verifikasi online.", "type": "integer" }, "session_seconds": { "description": "Masa berlaku maksimum sesi otorisasi dalam detik.", "type": "integer" }, "updated_at": { "description": "Waktu pembuatan catatan dalam UTC.", "format": "date-time", "type": "string" } }, "required": [ "id", "issuer", "audience", "environment", "enabled" ], "type": "object" }, "LaunchConnectionInput": { "additionalProperties": false, "properties": { "audience": { "description": "Penerima yang tepat dan dituju oleh assertion login Launch.", "maxLength": 255, "minLength": 1, "type": "string" }, "enabled": { "description": "Apakah koneksi kepercayaan ini dapat mengotorisasi penggunaan runtime baru.", "type": "boolean" }, "environment": { "description": "Lingkungan perdagangan, dipatok pada koneksi dan grant bertanda tangan.", "enum": [ "live", "sandbox" ], "type": "string" }, "heartbeat_seconds": { "default": 600, "description": "Interval verifikasi online yang dipilih server dalam detik.", "maximum": 86400, "minimum": 600, "type": "integer" }, "issuer": { "description": "Origin Launch tepercaya yang tepat tanpa path atau garis miring di akhir. HTTPS adalah default. HTTP memerlukan allow_http pada kunci API yang membuat permintaan ini; IP privat dan hostname internal didukung. Tidak ada permintaan callback atau discovery ke origin ini.", "format": "uri", "type": "string" }, "offline_seconds": { "default": 0, "description": "0 mewajibkan verifikasi online. Durasi offline positif harus setidaknya 3 × heartbeat_seconds. Izin akun offline permanen dinonaktifkan.", "maximum": 86400, "minimum": 0, "type": "integer" }, "public_keys": { "additionalProperties": { "description": "Kunci publik Ed25519 Base64URL kanonis yang dipatok, 32 byte.", "type": "string" }, "description": "Set lengkap kunci publik Ed25519 Launch yang dipatok dan diindeks berdasarkan ID kunci.", "maxProperties": 16, "minProperties": 1, "type": "object" }, "session_seconds": { "default": 86400, "description": "Setidaknya 3 × heartbeat_seconds.", "maximum": 2592000, "minimum": 1800, "type": "integer" } }, "required": [ "issuer", "audience", "environment", "public_keys", "enabled" ], "type": "object" }, "LaunchDeviceReleaseInput": { "additionalProperties": false, "properties": { "account_ref": { "description": "Referensi hak pembelian yang tidak dapat diubah dan peka huruf besar/kecil.", "pattern": "^[A-Za-z0-9_-]{1,128}$", "type": "string" }, "entitlement_ref": { "description": "Referensi hak pembelian yang tidak dapat diubah dan peka huruf besar/kecil.", "pattern": "^[A-Za-z0-9_-]{1,128}$", "type": "string" }, "environment": { "description": "Lingkungan perdagangan, dipatok pada koneksi dan grant bertanda tangan.", "enum": [ "live", "sandbox" ], "type": "string" }, "expected_generation": { "description": "Generasi pengikatan perangkat yang diharapkan, dibandingkan di dalam transaksi pencabutan.", "minimum": 1, "type": "integer" }, "operation_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } }, "required": [ "operation_id", "account_ref", "entitlement_ref", "environment", "expected_generation" ], "type": "object" }, "LaunchEvent": { "additionalProperties": false, "properties": { "applied_at": { "anyOf": [ { "description": "Waktu pembuatan catatan dalam UTC.", "format": "date-time", "type": "string" }, { "description": "Waktu snapshot diterapkan atau diklasifikasikan sebagai usang.", "type": "null" } ], "description": "Waktu snapshot diterapkan atau diklasifikasikan sebagai usang." }, "attempts": { "description": "Jumlah percobaan pemrosesan gagal yang dipertahankan oleh Licentivo.", "type": "integer" }, "available_at": { "description": "Waktu pembuatan catatan dalam UTC.", "format": "date-time", "type": "string" }, "connection_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "created_at": { "description": "Waktu pembuatan catatan dalam UTC.", "format": "date-time", "type": "string" }, "error_code": { "description": "Alasan pemrosesan atau peninjauan yang stabil; kosong setelah berhasil.", "type": "string" }, "event_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "status": { "description": "Siklus hidup atau status pemrosesan saat ini yang dimiliki server.", "enum": [ "pending", "applied", "stale", "manual_review" ], "type": "string" } }, "required": [ "connection_id", "event_id", "status", "attempts", "available_at" ], "type": "object" }, "LaunchExchangeInput": { "additionalProperties": false, "properties": { "activation_id": { "description": "data.activation_id dari aktivasi terakhir yang berhasil. Wajib untuk validasi, heartbeat, consume, dan deaktivasi; hilangkan hanya pada activate pertama.", "format": "uuid", "type": "string" }, "app_version": { "description": "Versi aplikasi saat ini, major.minor.patch, misalnya 1.0.0. Wajib untuk aturan pemeliharaan atau rentang versi. Jangan melaporkan aplikasi yang lebih baru sebagai versi lama.", "pattern": "^$|^(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})$", "type": "string" }, "device_id": { "description": "SHA-256 heksadesimal huruf kecil sepanjang 64 karakter yang dihitung SDK dari identitas produk, sistem, dan perangkat keras. Jangan ganti dengan nilai tetap.", "pattern": "^[0-9a-f]{64}$", "type": "string" }, "device_name": { "description": "Nama tampilan di dasbor, hingga 120 karakter. Tidak menentukan identitas perangkat.", "maxLength": 120, "type": "string" }, "device_profile": { "$ref": "#/components/schemas/DeviceProfile", "description": "Profil mesin yang dibuat SDK. Berikan sesuai kebutuhan kebijakan untuk identitas perangkat keras, penolakan VM, atau migrasi perangkat keras." }, "environment": { "description": "Lingkungan perdagangan, dipatok pada koneksi dan grant bertanda tangan.", "enum": [ "live", "sandbox" ], "type": "string" }, "feature": { "description": "Pengenal fitur yang dikonsumsi.", "maxLength": 64, "type": "string" }, "identity_token": { "description": "JWT identitas Launch Ed25519 sekali pakai dan bertipe; tidak ada klaim entitlement yang dipercaya sebagai hak pembelian.", "maxLength": 12288, "type": "string", "writeOnly": true }, "launch_connection_id": { "description": "launch connection id untuk operasi otorisasi Launch ini.", "format": "uuid", "type": "string" }, "license_key": { "const": "", "description": "Hilangkan atau biarkan kosong. Pertukaran akun tidak pernah menggunakan kunci lisensi jangka panjang.", "type": "string" }, "product_id": { "description": "UUID produk; harus cocok dengan produk lisensi.", "format": "uuid", "type": "string" }, "quantity": { "description": "Unit yang diminta untuk operasi ini, bilangan bulat 1–1000000000.", "maximum": 1000000000, "minimum": 1, "type": "integer" }, "request_logout_ticket": { "description": "Negosiasi kemampuan SDK. Minta tiket logout khusus unlink jika tidak ada tiket yang disimpan untuk pengikatan saat ini. Hilangkan jika tiket logout valid sudah disimpan; heartbeat kondisi stabil menghindari pencarian tiket tambahan.", "type": "boolean" }, "reservation_id": { "description": "ID reservasi; kirim nilai ini untuk commit atau cancel.", "format": "uuid", "type": "string" }, "reservation_seconds": { "default": 900, "description": "Masa berlaku reservasi opsional, 30–3600 detik; default 900. Berakhir lebih awal saat reset periode.", "maximum": 3600, "minimum": 30, "type": "integer" }, "session_id": { "description": "Wajib untuk lisensi floating: buat UUID per instance yang berjalan dan gunakan kembali untuk permintaan instance tersebut. Opsional untuk lisensi terikat perangkat.", "format": "uuid", "type": "string" } }, "required": [ "product_id", "device_id", "identity_token", "launch_connection_id", "environment" ], "type": "object" }, "LaunchPlanMappingInput": { "additionalProperties": false, "properties": { "launch_product_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "policy_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "policy_version": { "description": "Versi saat ini yang diharapkan dari kebijakan otorisasi yang dipetakan.", "minimum": 1, "type": "integer" }, "product_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } }, "required": [ "launch_product_id", "product_id", "policy_id", "policy_version" ], "type": "object" }, "LaunchSessionRevocation": { "additionalProperties": false, "properties": { "account_ref": { "description": "Referensi hak pembelian yang tidak dapat diubah dan peka huruf besar/kecil.", "pattern": "^[A-Za-z0-9_-]{1,128}$", "type": "string" }, "completed_at": { "description": "Waktu pembuatan catatan dalam UTC.", "format": "date-time", "type": "string" }, "connection_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "created_at": { "description": "Waktu pembuatan catatan dalam UTC.", "format": "date-time", "type": "string" }, "environment": { "description": "Lingkungan perdagangan, dipatok pada koneksi dan grant bertanda tangan.", "enum": [ "live", "sandbox" ], "type": "string" }, "event_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "reason": { "description": "Alasan audit opsional; kosong setara dengan penghilangan. forced_logout memerlukan cakupan session; password_changed dan account_disabled memerlukan cakupan account.", "enum": [ "", "forced_logout", "password_changed", "account_disabled" ], "type": "string" }, "released_devices": { "description": "Generasi pengikatan perangkat saat ini yang dilepas; login yang lebih baru dipertahankan.", "minimum": 0, "type": "integer" }, "revoked_before": { "description": "Ada untuk cakupan account. Autentikasi baru harus memiliki auth_time yang benar-benar lebih besar dari cutoff UTC ini, dibandingkan dengan presisi detik Unix. Nilai sid yang telah diketahui sebelumnya tetap dicabut secara permanen.", "format": "date-time", "type": "string" }, "revoked_credentials": { "description": "Kredensial perangkat yang baru dicabut oleh peristiwa asli.", "minimum": 0, "type": "integer" }, "revoked_sessions": { "description": "Sesi otorisasi yang baru dicabut oleh peristiwa asli.", "minimum": 0, "type": "integer" }, "scope": { "description": "session mencabut satu sid Launch di semua produk dan perangkat dalam koneksi ini; account mencabut semua sesi akun yang ada dan menolak assertion autentikasi lama.", "enum": [ "session", "account" ], "type": "string" }, "sid": { "description": "Wajib dan tidak kosong untuk cakupan session; hilangkan atau biarkan kosong untuk cakupan account. Ini adalah sid login Launch, bukan sesi otorisasi Licentivo atau ID perangkat.", "pattern": "^[A-Za-z0-9_-]{0,128}$", "type": "string" }, "status": { "const": "succeeded", "description": "Siklus hidup atau status pemrosesan saat ini yang dimiliki server.", "type": "string" } }, "required": [ "connection_id", "event_id", "environment", "account_ref", "scope", "status", "revoked_sessions", "revoked_credentials", "released_devices", "created_at", "completed_at" ], "type": "object" }, "LaunchSessionRevocationInput": { "additionalProperties": false, "oneOf": [ { "properties": { "reason": { "enum": [ "", "forced_logout" ] }, "scope": { "const": "session" }, "sid": { "description": "Referensi hak pembelian yang tidak dapat diubah dan peka huruf besar/kecil.", "pattern": "^[A-Za-z0-9_-]{1,128}$", "type": "string" } }, "required": [ "sid" ] }, { "properties": { "reason": { "enum": [ "", "password_changed", "account_disabled" ] }, "scope": { "const": "account" }, "sid": { "const": "" } } } ], "properties": { "account_ref": { "description": "Referensi hak pembelian yang tidak dapat diubah dan peka huruf besar/kecil.", "pattern": "^[A-Za-z0-9_-]{1,128}$", "type": "string" }, "environment": { "description": "Pemeriksaan konsistensi opsional. Hilangkan atau biarkan kosong untuk menggunakan lingkungan koneksi; nilai yang tidak kosong harus cocok. Bidang ini tidak mengubah penagihan atau menyediakan pengujian otorisasi gratis.", "enum": [ "", "live", "sandbox" ], "type": "string" }, "event_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "reason": { "description": "Alasan audit opsional; kosong setara dengan penghilangan. forced_logout memerlukan cakupan session; password_changed dan account_disabled memerlukan cakupan account.", "enum": [ "", "forced_logout", "password_changed", "account_disabled" ], "type": "string" }, "scope": { "description": "session mencabut satu sid Launch di semua produk dan perangkat dalam koneksi ini; account mencabut semua sesi akun yang ada dan menolak assertion autentikasi lama.", "enum": [ "session", "account" ], "type": "string" }, "sid": { "description": "Wajib dan tidak kosong untuk cakupan session; hilangkan atau biarkan kosong untuk cakupan account. Ini adalah sid login Launch, bukan sesi otorisasi Licentivo atau ID perangkat.", "pattern": "^[A-Za-z0-9_-]{0,128}$", "type": "string" } }, "required": [ "event_id", "account_ref", "scope" ], "type": "object" }, "Lease": { "additionalProperties": false, "properties": { "key_id": { "description": "UUID kunci publik penandatanganan; harus ada dalam trusted_keys produk.", "format": "uuid", "type": "string" }, "payload": { "description": "Base64URL tanpa padding dari byte JSON lisensi asli. Decoding hanya untuk membaca; verifikasi tanda tangan wajib dilakukan.", "type": "string" }, "signature": { "description": "Tanda tangan Ed25519 Base64URL. Verifikasi teks LicenovaLease/v1, satu baris baru, dan byte JSON payload asli yang telah didekode. Jangan serialisasi ulang JSON. Tanda tangan yang didekode berukuran 64 byte.", "type": "string" }, "version": { "const": 1, "description": "Versi protokol envelope tanda tangan, saat ini 1.", "type": "integer" } }, "required": [ "version", "key_id", "payload", "signature" ], "type": "object" }, "LeaseClaims": { "additionalProperties": false, "description": "Dekode byte payload asli yang ditandatangani. Tanpa runtime_policy, TTL dibatasi pada 86400 detik; jika tidak, terapkan kebijakan yang ditandatangani. Jangan pernah mempercayai payload tanpa verifikasi tanda tangan/konteks.", "properties": { "activation_id": { "format": "uuid", "type": "string" }, "capabilities": { "$ref": "#/components/schemas/SignedCapabilities" }, "device_id": { "pattern": "^[0-9a-f]{64}$", "type": "string" }, "expires_at": { "maximum": 253402300799, "type": "integer" }, "features": { "items": { "pattern": "^[A-Za-z0-9_.-]{1,64}$", "type": "string" }, "maxItems": 32, "type": "array", "uniqueItems": true }, "issued_at": { "type": "integer" }, "key_id": { "format": "uuid", "type": "string" }, "license_id": { "format": "uuid", "type": "string" }, "max_devices": { "maximum": 10000, "minimum": 1, "type": "integer" }, "mode": { "enum": [ "perpetual", "timed", "trial" ], "type": "string" }, "offline_request_id": { "format": "uuid", "type": "string" }, "product_id": { "format": "uuid", "type": "string" }, "runtime_policy": { "$ref": "#/components/schemas/RuntimePolicy" }, "tenant_id": { "format": "uuid", "type": "string" }, "version": { "const": 1, "type": "integer" } }, "required": [], "type": "object" }, "LegalAcceptance": { "additionalProperties": false, "properties": { "accepted_at": { "format": "date-time", "type": "string" }, "api_overage_accepted": { "type": "boolean" }, "device_overage_accepted": { "type": "boolean" }, "digest": { "type": "string" }, "id": { "format": "uuid", "type": "string" }, "mode": { "type": "string" }, "overage_accepted": { "type": "boolean" }, "price_version": { "type": "string" }, "reference": { "type": "string" }, "scope": { "type": "string" }, "version": { "type": "string" } }, "required": [], "type": "object" }, "LegalAcceptanceList": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/LegalAcceptance" }, "type": "array" }, "now": { "format": "date-time", "type": "string" }, "total": { "type": "integer" } }, "required": [], "type": "object" }, "LegalConsent": { "additionalProperties": false, "properties": { "overage_accepted": { "description": "Otorisasi eksplisit terpisah untuk kelebihan penggunaan berbayar yang ditampilkan.", "type": "boolean" }, "policy_version": { "description": "Versi kebijakan tidak berubah yang saat ini diterbitkan. Wajib untuk tindakan yang dilindungi persetujuan setelah operator menerbitkan kebijakan, pada kedua lingkungan pembayaran.", "type": "string" }, "terms_accepted": { "description": "Persetujuan eksplisit yang secara default tidak dicentang.", "type": "boolean" } }, "required": [], "type": "object" }, "License": { "additionalProperties": false, "description": "Kedaluwarsa null sampai aktivasi pertama berhasil. Durasi dicatat saat penerbitan; aktivasi ulang tidak pernah mengatur ulang durasinya.", "example": { "created_at": "2026-10-18T00:00:00Z", "customer": "Order #1001", "duration_days": 30, "expires_at": null, "features": [ "export" ], "first_activated_at": null, "id": "33333333-3333-4333-8333-333333333333", "key_prefix": "lv_lic_AAAAAAA", "max_devices": 1, "mode": "timed", "policy_id": "22222222-2222-4222-8222-222222222222", "policy_version": 1, "product_id": "11111111-1111-4111-8111-111111111111", "status": "active", "updated_at": "2026-10-18T00:00:00Z" }, "properties": { "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "customer": { "description": "Label pelanggan yang ditentukan vendor, berbeda dari email portal pelanggan.", "type": "string" }, "duration_days": { "description": "Hari per lisensi sejak aktivasi pertama. Wajib 1–36500 untuk penerbitan timed/trial; tidak ada/null untuk perpetual. Tidak pernah disimpan dalam kebijakan.", "type": [ "integer", "null" ] }, "expires_at": { "anyOf": [ { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "format": "date-time", "type": "string" }, { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "type": "null" } ], "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial." }, "features": { "description": "Hingga 32 pengenal fitur yang berbeda, masing-masing 1–64 huruf ASCII, angka, titik, tanda hubung, atau garis bawah.", "items": { "pattern": "^[A-Za-z0-9_.-]{1,64}$", "type": "string" }, "maxItems": 32, "type": "array", "uniqueItems": true }, "first_activated_at": { "anyOf": [ { "description": "Stempel waktu aktivasi pertama yang berhasil; null sebelum aktivasi dan tidak berubah oleh perpanjangan atau transfer.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu aktivasi pertama yang berhasil; null sebelum aktivasi dan tidak berubah oleh perpanjangan atau transfer.", "type": "null" } ], "description": "Stempel waktu aktivasi pertama yang berhasil; null sebelum aktivasi dan tidak berubah oleh perpanjangan atau transfer." }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "key_prefix": { "description": "Awalan pendek kunci lisensi untuk identifikasi/pencarian, bukan autentikasi.", "type": "string" }, "max_devices": { "description": "Maksimum perangkat bersamaan atau kursi floating per lisensi.", "type": "integer" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "perpetual", "timed", "trial" ], "type": "string" }, "policy_id": { "description": "UUID kebijakan; harus milik produk saat penerbitan.", "format": "uuid", "type": "string" }, "policy_version": { "description": "Revisi kebijakan; kirim nilai saat ini saat mengedit kemampuan lengkap untuk mencegah penulisan usang.", "type": "integer" }, "product_id": { "description": "UUID produk di ruang kerja saat ini.", "format": "uuid", "type": "string" }, "status": { "description": "Status resource saat ini; lihat enum dan catatan operasi.", "enum": [ "active", "expired", "suspended", "revoked" ], "type": "string" }, "updated_at": { "description": "Stempel waktu pembaruan terakhir dalam UTC.", "format": "date-time", "type": "string" } }, "required": [ "id", "product_id", "key_prefix", "mode", "status" ], "type": "object" }, "LicenseCapabilities": { "additionalProperties": false, "example": { "license_id": "33333333-3333-4333-8333-333333333333", "license_model": "node_locked", "maintenance_days": 0, "maintenance_until": null, "max_version": "", "min_version": "", "product_id": "11111111-1111-4111-8111-111111111111", "updated_at": "2026-10-18T00:00:00Z" }, "properties": { "license_id": { "description": "UUID lisensi, berbeda dari rahasia lv_lic_.", "format": "uuid", "type": "string" }, "license_model": { "description": "Pengikatan perangkat node_locked atau kursi floating.", "enum": [ "node_locked", "floating" ], "type": "string" }, "maintenance_days": { "description": "Hari pemeliharaan sejak aktivasi pertama; 0 berarti tidak ada batas akhir pemeliharaan.", "type": "integer" }, "maintenance_until": { "anyOf": [ { "description": "Batas pemeliharaan untuk rilis baru; dapat null sebelum aktivasi atau ketika tak terbatas.", "format": "date-time", "type": "string" }, { "description": "Batas pemeliharaan untuk rilis baru; dapat null sebelum aktivasi atau ketika tak terbatas.", "type": "null" } ], "description": "Batas pemeliharaan untuk rilis baru; dapat null sebelum aktivasi atau ketika tak terbatas." }, "max_version": { "description": "Versi aplikasi maksimum yang diizinkan; kosong berarti tidak ada batas atas.", "type": "string" }, "min_version": { "description": "Versi aplikasi minimum yang diizinkan; kosong berarti tidak ada batas bawah.", "type": "string" }, "product_id": { "description": "UUID produk di ruang kerja saat ini.", "format": "uuid", "type": "string" }, "updated_at": { "description": "Stempel waktu pembaruan terakhir dalam UTC.", "format": "date-time", "type": "string" } }, "required": [ "license_id", "product_id", "license_model", "maintenance_days", "maintenance_until", "min_version", "max_version", "updated_at" ], "type": "object" }, "LicenseCapabilityResult": { "additionalProperties": false, "example": { "customer_email": "buyer@example.com", "license": { "license_id": "33333333-3333-4333-8333-333333333333", "license_model": "node_locked", "maintenance_days": 0, "maintenance_until": null, "max_version": "", "min_version": "", "product_id": "11111111-1111-4111-8111-111111111111", "updated_at": "2026-10-18T00:00:00Z" }, "meter_rules": [], "usage": null }, "properties": { "customer_email": { "description": "Email portal pelanggan yang terhubung; kosong jika belum ditetapkan.", "type": "string" }, "license": { "$ref": "#/components/schemas/LicenseCapabilities", "description": "Snapshot kemampuan lisensi." }, "meter_rules": { "description": "Aturan pengukuran fitur; kosong berarti tidak ada yang dikonfigurasi.", "items": { "additionalProperties": false, "properties": { "allow_overage": { "description": "Apakah kelebihan penggunaan fitur diizinkan.", "type": "boolean" }, "feature": { "description": "Pengenal fitur terukur, yang harus ada dalam fitur kebijakan.", "pattern": "^[A-Za-z0-9_.-]{1,64}$", "type": "string" }, "limit": { "description": "Jumlah penggunaan fitur yang disertakan per periode pengukuran (bukan batas paginasi).", "maximum": 1000000000000, "minimum": 0, "type": "integer" }, "max_overage": { "description": "Kelebihan penggunaan maksimum yang diizinkan; dinonaktifkan ketika allow_overage bernilai false.", "maximum": 1000000000000, "minimum": 0, "type": "integer" }, "period": { "description": "Snapshot penagihan bulanan UTC default; aturan meter menggunakan month/day/lifetime dan baris penggunaan menggunakan kunci periode konkret.", "enum": [ "month", "day", "lifetime" ], "type": "string" } }, "required": [ "feature", "limit", "period" ], "type": "object" }, "type": "array" }, "usage": { "anyOf": [ { "description": "Catatan penggunaan fitur aktual; dapat null jika kosong.", "items": { "$ref": "#/components/schemas/FeatureUsage" }, "type": "array" }, { "description": "Catatan penggunaan fitur aktual; dapat null jika kosong.", "type": "null" } ], "description": "Catatan penggunaan fitur aktual; dapat null jika kosong." } }, "required": [], "type": "object" }, "LicenseCreate": { "additionalProperties": false, "description": "Terbitkan lisensi dengan duration_days miliknya sendiri. Lisensi timed/trial memerlukan 1–36500 hari; lisensi perpetual memerlukan nilai tidak ada/null. Waktu mulai pada aktivasi pertama yang berhasil.", "properties": { "customer": { "description": "Nama pelanggan atau referensi pesanan untuk pencarian dasbor, hingga 254 karakter.", "maxLength": 254, "type": "string" }, "customer_email": { "description": "Email portal pelanggan yang terhubung; kosong jika belum ditetapkan.", "format": "email", "maxLength": 254, "type": "string" }, "duration_days": { "description": "Durasi lisensi dalam hari, dimulai pada aktivasi pertama yang berhasil. Wajib untuk penerbitan timed/trial; hilangkan atau null untuk lisensi perpetual. Tidak pernah diwarisi dari kebijakan.", "maximum": 36500, "minimum": 1, "type": [ "integer", "null" ] }, "policy_id": { "description": "UUID kebijakan lisensi milik produk ini.", "format": "uuid", "type": "string" }, "product_id": { "description": "ID produk (UUID).", "format": "uuid", "type": "string" } }, "required": [ "product_id", "policy_id" ], "type": "object" }, "LicenseKeyReveal": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "type": "string" }, "key": { "description": "Original full license key, revealed only to a current Owner session.", "type": "string" }, "key_prefix": { "type": "string" } }, "required": [ "id", "key", "key_prefix" ], "type": "object" }, "LicenseList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/License" }, "type": "array" }, "limit": { "description": "Ukuran halaman, default 25, rentang 1–100.", "type": "integer" }, "offset": { "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "type": "integer" }, "total": { "description": "Total catatan yang cocok, bukan panjang halaman saat ini.", "type": "integer" } }, "required": [ "items", "total", "limit", "offset" ], "type": "object" }, "LicenseSecret": { "additionalProperties": false, "example": { "duration_days": 30, "expires_at": null, "first_activated_at": null, "id": "33333333-3333-4333-8333-333333333333", "key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "key_prefix": "lv_lic_AAAAAAA" }, "properties": { "duration_days": { "description": "Hari berlaku sejak aktivasi pertama; null untuk lisensi perpetual.", "type": [ "integer", "null" ] }, "expires_at": { "anyOf": [ { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "format": "date-time", "type": "string" }, { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "type": "null" } ], "description": "Kedaluwarsa akhir lisensi, UTC ISO 8601; null sebelum aktivasi pertama dan untuk lisensi perpetual." }, "first_activated_at": { "anyOf": [ { "description": "Stempel waktu aktivasi pertama yang berhasil; null sebelum aktivasi dan tidak berubah oleh perpanjangan atau transfer.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu aktivasi pertama yang berhasil; null sebelum aktivasi dan tidak berubah oleh perpanjangan atau transfer.", "type": "null" } ], "description": "Aktivasi pertama yang berhasil, UTC ISO 8601; null sebelum aktivasi. Transfer perangkat tidak mengatur ulangnya." }, "id": { "description": "UUID catatan lisensi untuk kueri manajemen, perpanjangan, atau pencabutan. Ini bukan kunci aktivasi.", "format": "uuid", "type": "string" }, "key": { "description": "Kunci lisensi lengkap yang dimulai dengan lv_lic_. Ditampilkan sekali saat penerbitan; vendor harus menyimpannya secara privat dan memberikannya kepada pelanggan.", "type": "string" }, "key_prefix": { "description": "Awalan kunci untuk identifikasi dasbor; tidak dapat mengaktifkan lisensi.", "type": "string" } }, "required": [ "id", "key", "key_prefix" ], "type": "object" }, "LicenseUpdate": { "additionalProperties": false, "properties": { "customer": { "description": "Label pelanggan yang ditentukan vendor, berbeda dari email portal pelanggan.", "maxLength": 254, "type": "string" }, "features": { "description": "Hingga 32 pengenal fitur yang berbeda, masing-masing 1–64 huruf ASCII, angka, titik, tanda hubung, atau garis bawah.", "items": { "pattern": "^[A-Za-z0-9_.-]{1,64}$", "type": "string" }, "maxItems": 32, "type": "array", "uniqueItems": true }, "max_devices": { "description": "Maksimum perangkat bersamaan atau kursi floating per lisensi.", "maximum": 10000, "minimum": 1, "type": "integer" }, "policy_id": { "description": "Alihkan lisensi ini ke kebijakan untuk produk yang sama. Perubahan kebijakan memerlukan preview_token yang masih berlaku; kunci lisensi, masa berlaku awal, dan penggunaan tetap dipertahankan.", "format": "uuid", "type": "string" }, "preview_token": { "description": "Token yang dikembalikan POST /licenses/policy-preview untuk lisensi ini dan kebijakan tujuan.", "type": "string" }, "status": { "description": "Status resource saat ini; lihat enum dan catatan operasi.", "enum": [ "active", "suspended", "revoked" ], "type": "string" } }, "required": [], "type": "object" }, "LicensingWebhook": { "additionalProperties": false, "properties": { "created_at": { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "format": "date-time", "type": "string" }, "enabled": { "description": "Apakah HTTP diizinkan, hanya untuk pengembangan lokal.", "type": "boolean" }, "events": { "description": "Jenis peristiwa langganan yang tidak kosong dan berbeda.", "items": { "enum": [ "license.created", "license.updated", "license.renewed", "license.revoked", "license.activate", "license.deactivate", "license.consume", "license.expiring", "license.expired", "license.maintenance_expiring", "license.maintenance_expired" ], "type": "string" }, "type": "array" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "name": { "description": "Nama yang dapat dibaca manusia; lihat batas panjang.", "type": "string" }, "updated_at": { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "format": "date-time", "type": "string" }, "url": { "description": "URL penerima peristiwa; gunakan HTTPS publik dalam produksi.", "type": "string" } }, "required": [ "id", "name", "url", "events", "enabled", "created_at", "updated_at" ], "type": "object" }, "LicensingWebhookInput": { "additionalProperties": false, "properties": { "enabled": { "description": "Apakah endpoint webhook diaktifkan.", "type": "boolean" }, "events": { "description": "Jenis peristiwa langganan yang tidak kosong dan berbeda.", "items": { "enum": [ "license.created", "license.updated", "license.renewed", "license.revoked", "license.activate", "license.deactivate", "license.consume", "license.expiring", "license.expired", "license.maintenance_expiring", "license.maintenance_expired" ], "type": "string" }, "type": "array" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "name": { "description": "Nama yang dapat dibaca manusia; lihat batas panjang.", "maxLength": 120, "type": "string" }, "secret": { "description": "Rahasia verifikasi webhook, 32–200 karakter jika diberikan; penghilangan saat pembaruan mempertahankannya. Output kosong berarti tidak diterbitkan ulang.", "maxLength": 200, "minLength": 32, "type": "string", "writeOnly": true }, "url": { "description": "URL penerima peristiwa; gunakan HTTPS publik dalam produksi.", "format": "uri", "maxLength": 2000, "type": "string" } }, "required": [ "name", "url", "events", "enabled" ], "type": "object" }, "LicensingWebhookList": { "additionalProperties": false, "properties": { "event_types": { "description": "Semua jenis peristiwa lisensi yang didukung.", "items": { "enum": [ "license.created", "license.updated", "license.renewed", "license.revoked", "license.activate", "license.deactivate", "license.consume", "license.expiring", "license.expired", "license.maintenance_expiring", "license.maintenance_expired" ], "type": "string" }, "type": "array" }, "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/LicensingWebhook" }, "type": "array" } }, "required": [], "type": "object" }, "LicensingWebhookSecret": { "additionalProperties": false, "properties": { "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "secret": { "description": "Dikembalikan sekali untuk endpoint baru; kosong jika dipertahankan", "type": "string" } }, "required": [], "type": "object" }, "LoggedOut": { "additionalProperties": false, "properties": { "logged_out": { "type": "boolean" } }, "required": [ "logged_out" ], "type": "object" }, "Login": { "additionalProperties": false, "properties": { "email": { "format": "email", "type": "string" }, "password": { "description": "12–128 byte UTF-8, bukan karakter", "type": "string", "writeOnly": true } }, "required": [ "email", "password" ], "type": "object" }, "LogoutTicket": { "additionalProperties": false, "properties": { "activation_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "expected_generation": { "description": "Generasi pengikatan perangkat yang diharapkan, dibandingkan di dalam transaksi pencabutan.", "minimum": 1, "type": "integer" }, "operation_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "product_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "release_token": { "description": "Kemampuan khusus unlink. Tidak dapat mengaktifkan, memvalidasi, memperbarui, atau mengonsumsi fitur. Simpan hanya dalam jurnal logout SDK selama pencabutan tertunda.", "pattern": "^lv_out_[A-Za-z0-9_-]{43}$", "type": "string" } }, "required": [ "operation_id", "product_id", "activation_id", "expected_generation", "release_token" ], "type": "object" }, "MailConnection": { "additionalProperties": false, "properties": { "check_status": { "enum": [ "verified", "limited" ], "type": "string" }, "delivery_mode": { "enum": [ "file", "smtp", "resend", "brevo", "postmark", "mailgun" ], "type": "string" }, "message": { "type": "string" }, "mode": { "enum": [ "file", "smtp", "resend", "brevo", "postmark", "mailgun" ], "type": "string" }, "ok": { "description": "False untuk pemeriksaan terbatas: kredensial dan pengiriman belum dikonfirmasi.", "type": "boolean" }, "status": { "enum": [ "connected" ], "type": "string" } }, "required": [ "status", "mode", "delivery_mode", "ok", "check_status" ], "type": "object" }, "MailInput": { "additionalProperties": false, "description": "Pembaruan parsial pengaturan email platform terenkripsi. Bidang yang dihilangkan dan konfigurasi penyedia lain dipertahankan; kunci API dan kata sandi SMTP kosong mempertahankan rahasia yang ada. Layanan aktif yang dipilih harus dikonfigurasi sepenuhnya. Mode file tidak tersedia di produksi. Memerlukan sesi platform-admin dan token CSRF; kunci API manajemen vendor tidak dapat mengubah pengaturan email platform.", "properties": { "from": { "type": "string" }, "host": { "maxLength": 253, "type": "string" }, "mode": { "enum": [ "file", "smtp", "resend", "brevo", "postmark", "mailgun" ], "type": "string" }, "password": { "description": "Hilangkan atau biarkan kosong untuk mempertahankan kata sandi SMTP yang ada.", "maxLength": 1000, "type": "string", "writeOnly": true }, "port": { "maximum": 65535, "minimum": 1, "type": "integer" }, "providers": { "additionalProperties": false, "properties": { "brevo": { "$ref": "#/components/schemas/MailProviderInput" }, "mailgun": { "$ref": "#/components/schemas/MailgunInput" }, "postmark": { "$ref": "#/components/schemas/MailProviderInput" }, "resend": { "$ref": "#/components/schemas/MailProviderInput" } }, "required": [], "type": "object" }, "tls_mode": { "enum": [ "starttls", "implicit" ], "type": "string" }, "username": { "maxLength": 254, "type": "string" } }, "required": [], "type": "object" }, "MailJob": { "additionalProperties": false, "properties": { "attempts": { "type": "integer" }, "cancel_reason": { "enum": [ "", "platform_disabled", "customer_disabled", "coverage_changed", "reminder_window_changed", "renewal_state_changed", "purchase_unavailable", "workspace_unavailable", "recipient_unavailable", "unknown_notification" ], "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "delivered_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "id": { "format": "uuid", "type": "string" }, "kind": { "enum": [ "", "purchase_success", "expiry_reminder", "auto_renewal_success", "auto_renewal_problem", "billing_test" ], "type": "string" }, "mode": { "enum": [ "", "sandbox", "live" ], "type": "string" }, "recipient": { "type": "string" }, "status": { "enum": [ "pending", "running", "delivered", "failed", "cancelled" ], "type": "string" } }, "required": [ "id", "status", "attempts" ], "type": "object" }, "MailJobList": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/MailJob" }, "maxItems": 50, "type": "array" } }, "required": [ "items" ], "type": "object" }, "MailProviderInput": { "additionalProperties": false, "properties": { "api_key": { "description": "Kunci API penyedia; Postmark menggunakan Server API Token. Hilangkan atau biarkan kosong untuk mempertahankan rahasia tersimpan.", "maxLength": 4096, "type": "string", "writeOnly": true }, "from": { "description": "Email pengirim terverifikasi; wajib saat memilih penyedia ini sebagai aktif.", "type": "string" } }, "required": [], "type": "object" }, "MailProviderSettings": { "additionalProperties": false, "properties": { "api_key_configured": { "type": "boolean" }, "domain": { "description": "Domain pengiriman Mailgun; kosong untuk penyedia lain.", "type": "string" }, "from": { "type": "string" }, "region": { "description": "Wilayah Mailgun; kosong untuk penyedia lain.", "enum": [ "", "us", "eu" ], "type": "string" } }, "required": [ "from", "domain", "region", "api_key_configured" ], "type": "object" }, "MailQueued": { "additionalProperties": false, "properties": { "job_id": { "format": "uuid", "type": "string" }, "status": { "enum": [ "pending" ], "type": "string" } }, "required": [ "job_id", "status" ], "type": "object" }, "MailSettings": { "additionalProperties": false, "properties": { "from": { "type": "string" }, "host": { "type": "string" }, "mode": { "enum": [ "file", "smtp", "resend", "brevo", "postmark", "mailgun" ], "type": "string" }, "password_configured": { "type": "boolean" }, "port": { "type": "integer" }, "providers": { "additionalProperties": false, "properties": { "brevo": { "$ref": "#/components/schemas/MailProviderSettings" }, "mailgun": { "$ref": "#/components/schemas/MailProviderSettings" }, "postmark": { "$ref": "#/components/schemas/MailProviderSettings" }, "resend": { "$ref": "#/components/schemas/MailProviderSettings" } }, "required": [ "resend", "brevo", "postmark", "mailgun" ], "type": "object" }, "tls_mode": { "enum": [ "starttls", "implicit" ], "type": "string" }, "username": { "type": "string" } }, "required": [ "mode", "port", "password_configured", "providers" ], "type": "object" }, "MailgunInput": { "additionalProperties": false, "properties": { "api_key": { "description": "Kunci API akun Mailgun atau kunci pengiriman domain. Hilangkan atau biarkan kosong untuk mempertahankan rahasia tersimpan.", "maxLength": 4096, "type": "string", "writeOnly": true }, "domain": { "description": "Domain pengiriman, wajib saat Mailgun aktif; tanpa skema, path, atau port.", "maxLength": 253, "type": "string" }, "from": { "description": "Email pengirim terverifikasi; wajib saat Mailgun aktif.", "type": "string" }, "region": { "default": "us", "description": "Wilayah yang meng-host domain pengiriman; US dan EU menggunakan endpoint API tetap yang terpisah.", "enum": [ "us", "eu" ], "type": "string" } }, "required": [], "type": "object" }, "ManagementKeyBundle": { "additionalProperties": false, "properties": { "keys": { "description": "Kunci publik penandatanganan saat ini dan historis untuk produk.", "items": { "$ref": "#/components/schemas/SigningKey" }, "type": "array" }, "product_id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } }, "required": [ "product_id", "keys" ], "type": "object" }, "ManualRefundInput": { "additionalProperties": false, "properties": { "customer_agreement": { "maxLength": 3000, "type": "string" }, "evidence": { "maxLength": 3000, "type": "string" } }, "required": [ "customer_agreement", "evidence" ], "type": "object" }, "Me": { "additionalProperties": false, "properties": { "email": { "type": "string" }, "id": { "format": "uuid", "type": "string" }, "is_platform_admin": { "type": "boolean" }, "name": { "type": "string" }, "role": { "enum": [ "owner", "read_only" ], "type": "string" }, "tenant_id": { "format": "uuid", "type": "string" }, "tenant_name": { "type": "string" } }, "required": [ "tenant_id", "id", "role", "is_platform_admin" ], "type": "object" }, "Member": { "additionalProperties": false, "properties": { "email": { "type": "string" }, "id": { "format": "uuid", "type": "string" }, "is_platform_admin": { "type": "boolean" }, "name": { "type": "string" }, "role": { "enum": [ "owner", "read_only" ], "type": "string" }, "status": { "enum": [ "active", "disabled" ], "type": "string" }, "verified": { "type": "boolean" } }, "required": [ "id", "role", "status", "verified" ], "type": "object" }, "MemberList": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/Member" }, "type": "array" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "total": { "type": "integer" } }, "required": [ "items" ], "type": "object" }, "MemberUpdate": { "additionalProperties": false, "properties": { "role": { "enum": [ "owner", "read_only" ], "type": "string" }, "status": { "enum": [ "active", "disabled" ], "type": "string" } }, "required": [], "type": "object" }, "MonthInput": { "additionalProperties": false, "properties": { "month": { "description": "Bulan UTC YYYY-MM; nilai kueri yang dihilangkan menggunakan bulan saat ini. Job penagihan memerlukan bulan yang telah ditutup.", "pattern": "^[0-9]{4}-[0-9]{2}$", "type": "string" } }, "required": [ "month" ], "type": "object" }, "Notice": { "additionalProperties": false, "properties": { "message": { "type": "string" } }, "required": [ "message" ], "type": "object" }, "OfflineReleaseResult": { "additionalProperties": false, "example": { "activation_id": "44444444-4444-4444-8444-444444444444", "deactivated": true }, "properties": { "activation_id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "deactivated": { "description": "Apakah HTTP diizinkan, hanya untuk pengembangan lokal.", "type": "boolean" } }, "required": [ "activation_id", "deactivated" ], "type": "object" }, "OfflineRequest": { "additionalProperties": false, "properties": { "activation_id": { "description": "UUID catatan aktivasi perangkat atau sesi floating.", "format": "uuid", "type": "string" }, "app_version": { "description": "Kosong untuk aktivasi biasa. Berikan versi aplikasi yang benar-benar diterbitkan hanya saat menggunakan batasan versi atau pemeliharaan.", "pattern": "^$|^(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})$", "type": "string" }, "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "type": "integer" }, "device_id": { "description": "SDK menurunkan identitas OS dan perangkat keras bercakupan produk menggunakan LicenovaDevice/v3. Konfigurasi tidak dapat mengganti mesin saat ini.", "pattern": "^[0-9a-f]{64}$", "type": "string" }, "device_name": { "description": "Label perangkat yang dapat dibaca manusia, bukan identitas keamanan.", "maxLength": 120, "type": "string" }, "device_profile": { "$ref": "#/components/schemas/DeviceProfile", "description": "Identitas perangkat yang dibuat SDK; berikan semua bidang turunan yang wajib jika ada." }, "license_key": { "description": "Kunci lisensi asli; kode lv_tmp_ sekali pakai hanya untuk activate; lalu kredensial lv_dev_ yang terikat mesin untuk operasi runtime. SDK menyimpan kredensial secara persisten terpisah dari lease.", "pattern": "^lv_(lic|tmp|dev)_[A-Za-z0-9_-]{43}$", "type": "string", "writeOnly": true }, "operation": { "description": "Nama operasi; batch mendukung create/renew/revoke/apply_policy dan permintaan offline activate/deactivate.", "enum": [ "activate", "deactivate" ], "type": "string" }, "product_id": { "description": "UUID produk di ruang kerja saat ini.", "format": "uuid", "type": "string" }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" }, "session_id": { "description": "Pengenal sesi instance floating; dapat dihilangkan untuk lisensi node-locked.", "format": "uuid", "type": "string" }, "version": { "const": 1, "description": "Revisi kebijakan, versi produk major.minor.patch, atau versi protokol offline 1, bergantung pada objek.", "type": "integer" } }, "required": [ "version", "request_id", "created_at", "operation", "product_id", "license_key", "device_id" ], "type": "object" }, "OfflineResponse": { "additionalProperties": false, "example": { "operation": "deactivate", "request_id": "55555555-5555-4555-8555-555555555555", "result": { "activation_id": "44444444-4444-4444-8444-444444444444", "deactivated": true }, "version": 1 }, "properties": { "operation": { "description": "Nama operasi; batch mendukung create/renew/revoke/apply_policy dan permintaan offline activate/deactivate.", "enum": [ "activate", "deactivate" ], "type": "string" }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" }, "result": { "anyOf": [ { "$ref": "#/components/schemas/RuntimeResult", "description": "Hasil operasi offline: aktivasi mengembalikan lease bertanda tangan; pelepasan mengembalikan deactivated." }, { "$ref": "#/components/schemas/OfflineReleaseResult", "description": "Hasil operasi offline: aktivasi mengembalikan lease bertanda tangan; pelepasan mengembalikan deactivated." } ], "description": "Hasil operasi offline: aktivasi mengembalikan lease bertanda tangan; pelepasan mengembalikan deactivated." }, "version": { "const": 1, "description": "Revisi kebijakan, versi produk major.minor.patch, atau versi protokol offline 1, bergantung pada objek.", "type": "integer" } }, "required": [ "version", "request_id", "operation", "result" ], "type": "object" }, "OnboardingInput": { "additionalProperties": false, "properties": { "description": { "description": "Deskripsi produk; boleh kosong.", "maxLength": 1000, "type": "string" }, "duration_days": { "description": "Hanya durasi lisensi uji yang dihasilkan; default 7 untuk timed/trial. Tidak disimpan dalam kebijakan yang dihasilkan.", "maximum": 36500, "minimum": 1, "type": [ "integer", "null" ] }, "features": { "default": [ "export" ], "description": "Hingga 32 pengenal fitur yang berbeda, masing-masing 1–64 huruf ASCII, angka, titik, tanda hubung, atau garis bawah.", "items": { "pattern": "^[A-Za-z0-9_.-]{1,64}$", "type": "string" }, "maxItems": 32, "type": "array", "uniqueItems": true }, "heartbeat_seconds": { "anyOf": [ { "const": 0, "description": "Interval heartbeat dalam detik: 0 menonaktifkannya; selain itu 600–86400. Jika dihilangkan menggunakan default server; independen dari jatah offline." }, { "description": "Interval heartbeat dalam detik: 0 menonaktifkannya; selain itu 600–86400. Jika dihilangkan menggunakan default server; independen dari jatah offline.", "maximum": 86400, "minimum": 600, "type": "integer" } ], "description": "0 secara eksplisit menonaktifkan heartbeat berkala; selain itu 600–86400 detik (minimum 10 menit). Independen dari jatah offline.", "type": "integer" }, "license_model": { "default": "node_locked", "description": "Pengikatan perangkat node_locked atau kursi floating.", "enum": [ "node_locked", "floating" ], "type": "string" }, "max_devices": { "default": 1, "description": "Maksimum perangkat bersamaan atau kursi floating per lisensi.", "maximum": 10000, "minimum": 1, "type": "integer" }, "mode": { "default": "trial", "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "perpetual", "timed", "trial" ], "type": "string" }, "name": { "description": "Nama yang dapat dibaca manusia; lihat batas panjang.", "maxLength": 120, "minLength": 1, "type": "string" }, "offline_mode": { "description": "Jatah offline limited, none, atau permanent; kedaluwarsa lisensi tetap berlaku.", "enum": [ "limited", "none", "permanent" ], "type": "string" }, "offline_seconds": { "description": "Limited: 1–31536000 detik dan setidaknya 3 × heartbeat_seconds saat heartbeat aktif; none/permanent: 0", "maximum": 31536000, "minimum": 0, "type": "integer" }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "request_id", "name" ], "type": "object" }, "OnboardingResult": { "additionalProperties": false, "example": { "config": { "allow_http": false, "app_version": "1.0.0", "base_url": "https://license.example.com", "cache_path": "", "device_name": "My application", "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "product_id": "11111111-1111-4111-8111-111111111111", "trusted_keys": { "66666666-6666-4666-8666-666666666666": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" } }, "license_id": "33333333-3333-4333-8333-333333333333", "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "next": "Choose a language and download the configured SDK bundle.", "policy_id": "22222222-2222-4222-8222-222222222222", "product_id": "11111111-1111-4111-8111-111111111111" }, "properties": { "config": { "$ref": "#/components/schemas/SDKConfig", "description": "Konfigurasi SDK uji privat yang berisi rahasia lisensi." }, "license_id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "license_key": { "description": "Kunci lisensi pelanggan lengkap yang diberikan saat aktivasi. Kode inisialisasi produk dan unduhan contoh tidak berisi rahasia ini. Permintaan offline menggunakan kredensial yang diberikan SDK.", "type": "string" }, "next": { "description": "Paket default terjadwal untuk bulan berikutnya, atau null.", "type": "string" }, "policy_id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "product_id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } }, "required": [ "product_id", "policy_id", "license_id", "license_key", "config", "next" ], "type": "object" }, "OperatorProfile": { "additionalProperties": false, "properties": { "backup_region": { "maxLength": 500, "type": "string" }, "contact": { "maxLength": 500, "type": "string" }, "country": { "maxLength": 500, "type": "string" }, "financial_retention_years": { "description": "Nol atau dihilangkan berarti belum dikonfirmasi dan tidak disertakan dalam dokumen publik.", "maximum": 30, "minimum": 0, "type": "integer" }, "hosting_provider": { "maxLength": 500, "type": "string" }, "mail_provider": { "maxLength": 500, "type": "string" }, "markets": { "maxLength": 500, "type": "string" }, "operator": { "maxLength": 500, "type": "string" }, "processing_grounds": { "maxLength": 500, "type": "string" }, "server_region": { "maxLength": 500, "type": "string" }, "transfer_safeguards": { "maxLength": 500, "type": "string" } }, "required": [], "type": "object" }, "OriginalRefundInput": { "additionalProperties": false, "properties": { "amount": { "pattern": "^[0-9]+(?:\\.[0-9]{1,2})?$", "type": "string" }, "reason": { "maxLength": 255, "minLength": 1, "type": "string" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "amount", "reason", "request_id" ], "type": "object" }, "OriginalRefundResult": { "additionalProperties": false, "properties": { "case_id": { "format": "uuid", "type": "string" }, "items": { "items": { "$ref": "#/components/schemas/ProviderRefund" }, "type": "array" } }, "type": "object" }, "OveragePlan": { "additionalProperties": false, "properties": { "api_hard_limit": { "description": "Apakah panggilan runtime berhenti pada batas jatah API.", "type": "boolean" }, "api_unit_micros": { "description": "Harga per kelebihan panggilan runtime dalam sepersejuta.", "minimum": 0, "type": "integer" }, "base_micros": { "description": "Biaya dasar dalam sepersejuta unit mata uang.", "type": "integer" }, "currency": { "description": "Kode mata uang huruf besar tiga huruf, seperti USD.", "type": "string" }, "description": { "description": "Deskripsi penawaran penagihan.", "type": "string" }, "enabled": { "description": "Apakah penawaran penagihan diaktifkan untuk dibeli.", "type": "boolean" }, "hard_limit": { "description": "Apakah perangkat baru yang dapat ditagih ditolak pada batas jatah.", "type": "boolean" }, "included_api_calls": { "description": "null = tak terbatas; 0 = tidak ada panggilan berhasil yang disertakan", "maximum": 1000000000000, "minimum": 0, "type": [ "integer", "null" ] }, "included_devices": { "description": "Jatah perangkat aktif yang disertakan.", "type": "integer" }, "name": { "description": "Nama tampilan penawaran penagihan.", "type": "string" }, "plan": { "description": "Pengenal paket penagihan stabil dari katalog yang diterbitkan.", "type": "string" }, "price_version": { "description": "Revisi harga yang dibekukan; input usang dapat menyebabkan PLAN_VERSION_CONFLICT.", "type": "string" }, "public": { "description": "Apakah penawaran penagihan tercantum secara publik.", "type": "boolean" }, "renewal_only": { "description": "Pelanggan berbayar atau penerima hadiah yang sudah ada dapat memperpanjang di muka atau setelah kedaluwarsa dalam lingkungan dan mata uang yang sama. Tersembunyi dari pembelian publik baru.", "type": "boolean" }, "sort_order": { "description": "Urutan tampilan penawaran penagihan.", "type": "integer" }, "terms": { "anyOf": [ { "description": "Jangka waktu pembelian yang tersedia dan harganya.", "items": { "$ref": "#/components/schemas/PlanTermPrice" }, "type": "array" }, { "description": "Jangka waktu pembelian yang tersedia dan harganya.", "type": "null" } ], "description": "Jangka waktu pembelian yang tersedia dan harganya." }, "unit_micros": { "description": "Harga per kelebihan perangkat aktif dalam sepersejuta.", "type": "integer" }, "updated_at": { "description": "Stempel waktu pembaruan terakhir dalam UTC.", "format": "date-time", "type": "string" } }, "required": [], "type": "object" }, "OveragePreference": { "additionalProperties": false, "properties": { "block_api_overage": { "description": "Apakah panggilan API runtime di luar jatah yang disertakan diblokir.", "type": "boolean" }, "block_device_overage": { "description": "Apakah perangkat baru yang dapat ditagih di luar jatah yang disertakan diblokir.", "type": "boolean" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "sandbox", "live" ], "type": "string" }, "updated_at": { "description": "Stempel waktu pembaruan terakhir dalam UTC.", "format": "date-time", "type": "string" }, "version": { "description": "Revisi konfigurasi preferensi kelebihan penggunaan.", "type": "string" } }, "required": [ "mode", "block_device_overage", "block_api_overage", "version", "updated_at" ], "type": "object" }, "OverageSettings": { "additionalProperties": false, "properties": { "customer_api_settings_enabled": { "description": "Apakah pelanggan dapat mengonfigurasi pemblokiran kelebihan API.", "type": "boolean" }, "customer_device_settings_enabled": { "description": "Apakah pelanggan dapat mengonfigurasi pemblokiran kelebihan perangkat.", "type": "boolean" }, "plan": { "anyOf": [ { "$ref": "#/components/schemas/OveragePlan", "description": "Pengenal paket penagihan stabil dari katalog yang diterbitkan." }, { "description": "Pengenal paket penagihan stabil dari katalog yang diterbitkan.", "type": "null" } ], "description": "Aturan jatah pembelian/default saat ini yang digunakan untuk menentukan kelebihan penggunaan, atau null jika tidak tersedia." }, "preference": { "$ref": "#/components/schemas/OveragePreference", "description": "Preferensi kelebihan penggunaan pelanggan yang tersimpan." } }, "required": [ "preference", "plan", "customer_device_settings_enabled", "customer_api_settings_enabled" ], "type": "object" }, "OverageSettingsInput": { "additionalProperties": false, "properties": { "block_api_overage": { "type": "boolean" }, "block_device_overage": { "type": "boolean" }, "expected_version": { "description": "Gunakan preference.version dari GET. Kosong untuk penyimpanan pertama. Perubahan dari tab lain mengembalikan 409; setidaknya satu pilihan kelebihan penggunaan diperlukan.", "type": "string" } }, "required": [ "expected_version" ], "type": "object" }, "PaddleCheck": { "additionalProperties": false, "properties": { "connected": { "description": "Apakah kanal ini menerima checkout baru. Rekonsiliasi historis tetap tersedia dengan kredensial yang dipertahankan.", "type": "boolean" }, "mode": { "description": "Lingkungan pembayaran. Catatan sandbox dan live diisolasi.", "enum": [ "sandbox", "live" ], "type": "string" } }, "required": [ "connected", "mode" ], "type": "object" }, "PaddleOrder": { "additionalProperties": false, "properties": { "amount_cents": { "description": "Harga layanan penuh yang dibekukan dalam unit mata uang terkecil; tanpa isi ulang dompet atau pembayaran campuran.", "type": "integer" }, "applied_at": { "anyOf": [ { "description": "Waktu UTC saat intent checkout lokal disimpan.", "format": "date-time", "type": "string" }, { "type": "null" } ], "description": "Waktu UTC saat pembayaran terverifikasi mengaktifkan layanan atau mengkredit isi ulang dompet. purchase_id dan upgrade_id null mengidentifikasi isi ulang." }, "created_at": { "description": "Waktu UTC saat intent checkout lokal disimpan.", "format": "date-time", "type": "string" }, "currency": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" }, "mode": { "description": "Lingkungan pembayaran. Catatan sandbox dan live diisolasi.", "enum": [ "sandbox", "live" ], "type": "string" }, "paid_at": { "anyOf": [ { "description": "Waktu UTC saat intent checkout lokal disimpan.", "format": "date-time", "type": "string" }, { "type": "null" } ], "description": "Waktu UTC saat backend memverifikasi transaksi Paddle yang selesai." }, "purchase_id": { "anyOf": [ { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" }, { "type": "null" } ], "description": "Pembelian layanan atau perpanjangan tertunda yang ada; saling eksklusif dengan upgrade_id." }, "refunded_cents": { "description": "Harga layanan penuh yang dibekukan dalam unit mata uang terkecil; tanpa isi ulang dompet atau pembayaran campuran.", "type": "integer" }, "request_id": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "status": { "description": "Siklus hidup pembayaran, termasuk paid_unapplied ketika dana yang terkumpul memerlukan peninjauan operator dan pengembalian dana.", "enum": [ "creating", "created", "completed", "paid_unapplied", "partially_refunded", "refunded" ], "type": "string" }, "transaction_id": { "anyOf": [ { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, { "type": "null" } ], "description": "Pengenal transaksi Paddle Billing yang terikat, atau null selama hasil pembuatan asli tertunda." }, "upgrade_id": { "anyOf": [ { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" }, { "type": "null" } ], "description": "Penawaran peningkatan tertunda yang ada; saling eksklusif dengan purchase_id." } }, "required": [ "id", "request_id", "mode", "transaction_id", "purchase_id", "upgrade_id", "currency", "amount_cents", "refunded_cents", "status", "paid_at", "applied_at", "created_at" ], "type": "object" }, "PaddleOrderInput": { "additionalProperties": false, "description": "Bayar satu pembelian/peningkatan yang dibekukan, atau buat isi ulang dompet dengan jumlah dan mata uang tanpa ID layanan. request_id yang stabil mengembalikan pembayaran asli; perubahan intent, jumlah, atau mata uang ditolak. Hanya pembayaran selesai yang diverifikasi secara independen yang mengkredit dompet atau mengaktifkan layanan. Pengembalian isi ulang masuk ke dompet. Hasil pembuatan yang tidak pasti dipulihkan dari webhook aslinya dan tidak pernah dibuat ulang secara membabi buta.", "oneOf": [ { "not": { "anyOf": [ { "required": [ "amount" ] }, { "required": [ "currency" ] } ] }, "properties": { "purchase_id": { "format": "uuid", "type": "string" }, "upgrade_id": { "type": "null" } }, "required": [ "purchase_id" ] }, { "not": { "anyOf": [ { "required": [ "amount" ] }, { "required": [ "currency" ] } ] }, "properties": { "purchase_id": { "type": "null" }, "upgrade_id": { "format": "uuid", "type": "string" } }, "required": [ "upgrade_id" ] }, { "properties": { "purchase_id": { "type": "null" }, "upgrade_id": { "type": "null" } }, "required": [ "amount", "currency" ] } ], "properties": { "amount": { "description": "Hanya wajib untuk isi ulang dompet. Jumlah tampilan desimal dalam batas yang dikonfigurasi. Pesanan layanan menolak jumlah dari klien.", "pattern": "^\\d+(?:\\.\\d{1,2})?$", "type": "string" }, "currency": { "description": "Hanya wajib untuk isi ulang dompet dan harus diaktifkan untuk penyedia ini.", "type": "string" }, "overage_accepted": { "description": "Otorisasi eksplisit terpisah untuk kelebihan penggunaan berbayar yang ditampilkan.", "type": "boolean" }, "policy_version": { "description": "Versi kebijakan tidak berubah yang saat ini diterbitkan. Wajib untuk tindakan yang dilindungi persetujuan setelah operator menerbitkan kebijakan, pada kedua lingkungan pembayaran.", "type": "string" }, "purchase_id": { "anyOf": [ { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" }, { "type": "null" } ], "description": "Pembelian layanan atau perpanjangan tertunda yang ada; saling eksklusif dengan upgrade_id." }, "request_id": { "description": "Kunci permintaan stabil yang dibuat pemanggil. Replay mengembalikan checkout asli.", "maxLength": 80, "type": "string" }, "terms_accepted": { "description": "Persetujuan eksplisit yang secara default tidak dicentang.", "type": "boolean" }, "upgrade_id": { "anyOf": [ { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" }, { "type": "null" } ], "description": "Penawaran peningkatan tertunda yang ada; saling eksklusif dengan purchase_id." } }, "required": [ "request_id" ], "type": "object" }, "PaddleOrderList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang terlihat oleh administrator atau ruang kerja ini.", "items": { "$ref": "#/components/schemas/PaddleOrder" }, "type": "array" }, "total": { "description": "Harga layanan penuh yang dibekukan dalam unit mata uang terkecil; tanpa isi ulang dompet atau pembayaran campuran.", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "PaddleOrderResult": { "additionalProperties": false, "properties": { "approval_url": { "description": "Halaman checkout lokal yang membuka transaksi Paddle terikat.", "format": "uri", "type": "string" }, "client_token": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "order": { "$ref": "#/components/schemas/PaddleOrder", "description": "Catatan pembayaran layanan Paddle bercakupan ruang kerja." }, "return_url": { "description": "URL dasbor dompet untuk isi ulang, URL rekonsiliasi harga untuk pembayaran layanan. URL kembali saja tidak pernah membuktikan pembayaran.", "format": "uri", "type": "string" } }, "required": [ "order", "client_token", "approval_url", "return_url" ], "type": "object" }, "PaddleReconcileInput": { "additionalProperties": false, "properties": { "transaction_id": { "description": "ID txn_ asli opsional, digunakan untuk memulihkan respons pembuatan yang hilang. Backend secara independen memverifikasi pesanan lokal, tenant, produk, mata uang, dan jumlahnya. Tidak dapat menggantikan transaksi yang sudah terikat.", "type": "string" } }, "required": [], "type": "object" }, "PaddleSettings": { "additionalProperties": false, "properties": { "api_key_configured": { "description": "Apakah kanal ini menerima checkout baru. Rekonsiliasi historis tetap tersedia dengan kredensial yang dipertahankan.", "type": "boolean" }, "checkout_url": { "description": "Gunakan halaman domain yang disetujui ini sebagai tautan pembayaran default Paddle.", "format": "uri", "type": "string" }, "client_token": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "currencies": { "description": "Mata uang berbeda yang diterima kanal ini; jumlah menggunakan dua angka desimal.", "items": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "type": "array" }, "enabled": { "description": "Apakah kanal ini menerima checkout baru. Rekonsiliasi historis tetap tersedia dengan kredensial yang dipertahankan.", "type": "boolean" }, "maximum_cents": { "description": "Isi ulang dompet maksimum dalam unit mata uang minor; default 100000 dan tidak boleh kurang dari minimum_cents.", "maximum": 100000000, "minimum": 1, "type": "integer" }, "minimum_cents": { "description": "Isi ulang dompet minimum dalam unit mata uang minor; default 100.", "maximum": 100000000, "minimum": 1, "type": "integer" }, "mode": { "description": "Lingkungan pembayaran. Catatan sandbox dan live diisolasi.", "enum": [ "sandbox", "live" ], "type": "string" }, "product_id": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "version": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "webhook_secret_configured": { "description": "Apakah kanal ini menerima checkout baru. Rekonsiliasi historis tetap tersedia dengan kredensial yang dipertahankan.", "type": "boolean" }, "webhook_url": { "description": "Daftarkan URL absolut ini sebagai tujuan notifikasi Paddle.", "format": "uri", "type": "string" } }, "required": [ "enabled", "mode", "client_token", "product_id", "currencies", "api_key_configured", "webhook_secret_configured", "version", "webhook_url", "checkout_url" ], "type": "object" }, "PaddleSettingsInput": { "additionalProperties": false, "properties": { "api_key": { "description": "Dienkripsi saat disimpan. Kosong mempertahankan nilai yang ada kecuali clear_api_key bernilai true.", "maxLength": 1000, "type": "string", "writeOnly": true }, "clear_api_key": { "description": "Apakah kanal ini menerima checkout baru. Rekonsiliasi historis tetap tersedia dengan kredensial yang dipertahankan.", "type": "boolean" }, "clear_webhook_secret": { "description": "Apakah kanal ini menerima checkout baru. Rekonsiliasi historis tetap tersedia dengan kredensial yang dipertahankan.", "type": "boolean" }, "client_token": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "currencies": { "description": "Mata uang berbeda yang diterima kanal ini; jumlah menggunakan dua angka desimal.", "items": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "type": "array" }, "enabled": { "description": "Apakah kanal ini menerima checkout baru. Rekonsiliasi historis tetap tersedia dengan kredensial yang dipertahankan.", "type": "boolean" }, "expected_version": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "maximum_cents": { "description": "Isi ulang dompet maksimum dalam unit mata uang minor; default 100000 dan tidak boleh kurang dari minimum_cents.", "maximum": 100000000, "minimum": 1, "type": "integer" }, "minimum_cents": { "description": "Isi ulang dompet minimum dalam unit mata uang minor; default 100.", "maximum": 100000000, "minimum": 1, "type": "integer" }, "mode": { "description": "Lingkungan pembayaran. Catatan sandbox dan live diisolasi.", "enum": [ "sandbox", "live" ], "type": "string" }, "product_id": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "webhook_secret": { "description": "Rahasia endpoint privat yang digunakan untuk mengautentikasi isi webhook mentah yang tepat.", "maxLength": 1000, "type": "string", "writeOnly": true } }, "required": [ "enabled", "mode", "client_token", "product_id", "currencies", "expected_version" ], "type": "object" }, "PaddleWebhookEvent": { "description": "Peristiwa Paddle Billing yang tidak diubah, diautentikasi dengan Paddle-Signature dan direkonsiliasi secara independen melalui API Paddle.", "type": "object" }, "PasswordSet": { "additionalProperties": false, "properties": { "password_set": { "type": "boolean" } }, "required": [ "password_set" ], "type": "object" }, "PayPalCheck": { "additionalProperties": false, "properties": { "connected": { "type": "boolean" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" } }, "required": [], "type": "object" }, "PayPalInput": { "additionalProperties": false, "properties": { "clear_secret": { "type": "boolean" }, "client_id": { "maxLength": 1000, "type": "string" }, "client_secret": { "description": "Kosong mempertahankan Secret tersimpan kecuali clear_secret=true", "maxLength": 1000, "type": "string", "writeOnly": true }, "currencies": { "items": { "pattern": "^[A-Z]{3}$", "type": "string" }, "type": "array" }, "enabled": { "type": "boolean" }, "expected_version": { "type": "string" }, "maximum_cents": { "maximum": 100000000, "type": "integer" }, "merchant_id": { "maxLength": 64, "type": "string" }, "minimum_cents": { "minimum": 1, "type": "integer" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "webhook_id": { "maxLength": 1000, "type": "string" } }, "required": [ "enabled", "mode", "client_id", "merchant_id", "webhook_id", "currencies", "minimum_cents", "maximum_cents", "expected_version" ], "type": "object" }, "PayPalOrder": { "additionalProperties": false, "properties": { "amount_cents": { "description": "Jumlah dalam seperseratus; entri ledger dapat berupa kredit positif atau debit negatif.", "type": "integer" }, "approval_url": { "description": "URL persetujuan pembayar PayPal; bukan bukti pembayaran.", "format": "uri", "type": "string" }, "capture_id": { "description": "Pengenal capture PayPal.", "type": [ "string", "null" ] }, "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "credited_at": { "anyOf": [ { "description": "Waktu isi ulang dikreditkan, atau null.", "format": "date-time", "type": "string" }, { "description": "Waktu isi ulang dikreditkan, atau null.", "type": "null" } ], "description": "Waktu isi ulang dikreditkan, atau null." }, "currency": { "description": "Kode mata uang huruf besar tiga huruf, seperti USD.", "pattern": "^[A-Z]{3}$", "type": "string" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "sandbox", "live" ], "type": "string" }, "paypal_order_id": { "description": "Pengenal pesanan PayPal, berbeda dari UUID catatan lokal.", "type": [ "string", "null" ] }, "purchase_id": { "description": "UUID pembelian paket terkait.", "type": [ "string", "null" ] }, "refunded_cents": { "description": "Jumlah kumulatif yang dikembalikan dalam seperseratus.", "type": "integer" }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "type": "string" }, "status": { "description": "Status resource saat ini; lihat enum dan catatan operasi.", "enum": [ "creating", "created", "credited", "refunded" ], "type": "string" }, "upgrade_id": { "anyOf": [ { "description": "UUID peningkatan terkait, atau kosong.", "format": "uuid", "type": "string" }, { "description": "UUID peningkatan terkait, atau kosong.", "type": "null" } ], "description": "UUID peningkatan terkait, atau kosong." } }, "required": [], "type": "object" }, "PayPalOrderList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/PayPalOrder" }, "type": "array" }, "limit": { "description": "Ukuran halaman, default 25, rentang 1–100.", "type": "integer" }, "offset": { "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "type": "integer" }, "total": { "description": "Total catatan yang cocok, bukan panjang halaman saat ini.", "type": "integer" } }, "required": [], "type": "object" }, "PayPalRefund": { "additionalProperties": false, "properties": { "amount_cents": { "description": "Pengembalian tunai jalur asli yang diminta dalam sen.", "type": "integer" }, "attempts": { "type": "integer" }, "case_id": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "currency": { "type": "string" }, "id": { "format": "uuid", "type": "string" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "order_id": { "format": "uuid", "type": "string" }, "paypal_refund_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reason": { "type": "string" }, "request_id": { "type": "string" }, "reserved": { "description": "True selama jumlah dompet ditahan. Timeout transport mempertahankan penahanan hingga permintaan yang sama direkonsiliasi.", "type": "boolean" }, "status": { "enum": [ "pending", "completed", "failed" ], "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "id", "order_id", "request_id", "mode", "currency", "amount_cents", "reason", "status", "reserved", "attempts", "paypal_refund_id", "created_at", "updated_at" ], "type": "object" }, "PayPalSettings": { "additionalProperties": false, "properties": { "client_id": { "maxLength": 1000, "type": "string" }, "currencies": { "items": { "pattern": "^[A-Z]{3}$", "type": "string" }, "type": "array" }, "enabled": { "type": "boolean" }, "maximum_cents": { "maximum": 100000000, "type": "integer" }, "merchant_id": { "maxLength": 64, "type": "string" }, "minimum_cents": { "minimum": 1, "type": "integer" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "secret_configured": { "type": "boolean" }, "version": { "type": "string" }, "webhook_id": { "maxLength": 1000, "type": "string" }, "webhook_url": { "format": "uri", "type": "string" } }, "required": [], "type": "object" }, "PaymentChannel": { "additionalProperties": false, "properties": { "currencies": { "description": "Mata uang berbeda yang diterima kanal ini; jumlah menggunakan dua angka desimal.", "items": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "type": "array" }, "enabled": { "description": "Apakah kanal ini menerima checkout baru. Rekonsiliasi historis tetap tersedia dengan kredensial yang dipertahankan.", "type": "boolean" }, "mode": { "description": "Lingkungan pembayaran. Catatan sandbox dan live diisolasi.", "enum": [ "sandbox", "live" ], "type": "string" }, "name": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "provider": { "description": "Penyedia pembayaran: PayPal, Paddle, atau Waffo Pancake.", "enum": [ "paypal", "paddle", "waffo" ], "type": "string" }, "version": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "wallet_topup": { "description": "Apakah kanal ini menerima checkout baru. Rekonsiliasi historis tetap tersedia dengan kredensial yang dipertahankan.", "type": "boolean" } }, "required": [ "provider", "name", "enabled", "mode", "currencies", "wallet_topup" ], "type": "object" }, "PaymentChannelInput": { "additionalProperties": false, "properties": { "paddle_enabled": { "description": "Apakah kanal ini menerima checkout baru. Rekonsiliasi historis tetap tersedia dengan kredensial yang dipertahankan.", "type": "boolean" }, "paddle_version": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "paypal_enabled": { "description": "Apakah kanal ini menerima checkout baru. Rekonsiliasi historis tetap tersedia dengan kredensial yang dipertahankan.", "type": "boolean" }, "paypal_version": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "waffo_enabled": { "description": "Sakelar Waffo opsional; bidang yang dihilangkan mempertahankan status saat ini.", "type": "boolean" }, "waffo_version": { "description": "Versi konfigurasi wajib saat mengubah sakelar Waffo.", "type": "string" } }, "required": [ "paypal_enabled", "paddle_enabled", "paypal_version", "paddle_version" ], "type": "object" }, "PaymentChannels": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang terlihat oleh administrator atau ruang kerja ini.", "items": { "$ref": "#/components/schemas/PaymentChannel" }, "type": "array" }, "mode": { "description": "Lingkungan pembayaran. Catatan sandbox dan live diisolasi.", "enum": [ "sandbox", "live" ], "type": "string" } }, "required": [ "items", "mode" ], "type": "object" }, "PendingPlan": { "additionalProperties": false, "properties": { "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "currency": { "description": "Kode mata uang huruf besar tiga huruf, seperti USD.", "type": "string" }, "effective_month": { "description": "Bulan UTC YYYY-MM saat jadwal berlaku.", "type": "string" }, "plan": { "description": "Pengenal paket penagihan stabil dari katalog yang diterbitkan.", "type": "string" }, "price_version": { "description": "Revisi harga yang dibekukan; input usang dapat menyebabkan PLAN_VERSION_CONFLICT.", "type": "string" } }, "required": [], "type": "object" }, "Period": { "additionalProperties": false, "properties": { "base_covered": { "description": "Apakah paket yang dibeli sudah mencakup biaya dasar.", "type": "boolean" }, "base_micros": { "description": "Biaya dasar dalam sepersejuta unit mata uang.", "type": "integer" }, "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "currency": { "description": "Kode mata uang huruf besar tiga huruf, seperti USD.", "pattern": "^[A-Z]{3}$", "type": "string" }, "hard_limit": { "description": "Apakah perangkat baru yang dapat ditagih ditolak pada batas jatah.", "type": "boolean" }, "included_devices": { "description": "Jatah perangkat aktif yang disertakan.", "type": "integer" }, "month": { "description": "Bulan UTC YYYY-MM; nilai kueri yang dihilangkan menggunakan bulan saat ini. Job penagihan memerlukan bulan yang telah ditutup.", "type": "string" }, "payment_mode": { "description": "Lingkungan pembayaran, sandbox atau live.", "enum": [ "sandbox", "live" ], "type": "string" }, "plan": { "description": "Pengenal paket penagihan stabil dari katalog yang diterbitkan.", "type": "string" }, "plan_name": { "description": "Nama tampilan paket.", "type": "string" }, "price_version": { "description": "Revisi harga yang dibekukan; input usang dapat menyebabkan PLAN_VERSION_CONFLICT.", "type": "string" }, "unit_micros": { "description": "Harga per kelebihan perangkat aktif dalam sepersejuta.", "type": "integer" } }, "required": [ "month", "plan", "currency", "price_version" ], "type": "object" }, "PlanChange": { "additionalProperties": false, "properties": { "currency": { "description": "Kode mata uang huruf besar tiga huruf, seperti USD.", "pattern": "^[A-Z]{3}$", "type": "string" }, "plan": { "description": "Pengenal paket penagihan stabil dari katalog yang diterbitkan.", "pattern": "^[a-z][a-z0-9_-]{0,63}$", "type": "string" }, "price_version": { "description": "Revisi harga yang dibekukan; input usang dapat menyebabkan PLAN_VERSION_CONFLICT.", "type": "string" } }, "required": [ "plan", "currency" ], "type": "object" }, "PlanGift": { "additionalProperties": false, "properties": { "batch_id": { "format": "uuid", "type": "string" }, "cancel_reason": { "type": "string" }, "cancelled_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "cancelled_by": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "ends_at": { "format": "date-time", "type": "string" }, "id": { "format": "uuid", "type": "string" }, "purchase_id": { "format": "uuid", "type": "string" }, "starts_at": { "format": "date-time", "type": "string" }, "status": { "enum": [ "granted", "cancelled" ], "type": "string" }, "tenant_id": { "format": "uuid", "type": "string" }, "user_id": { "format": "uuid", "type": "string" }, "value_cents": { "type": "integer" } }, "required": [ "id", "batch_id", "tenant_id", "user_id", "purchase_id", "value_cents", "status", "starts_at", "ends_at", "created_at", "cancelled_at" ], "type": "object" }, "PlanGiftBatch": { "additionalProperties": false, "properties": { "actor_id": { "format": "uuid", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "currency": { "type": "string" }, "id": { "format": "uuid", "type": "string" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "plan": { "type": "string" }, "plan_name": { "type": "string" }, "price_version": { "type": "string" }, "reason": { "maxLength": 500, "minLength": 1, "type": "string" }, "request_id": { "type": "string" }, "start_mode": { "type": "string" }, "tenant_count": { "type": "integer" }, "term_months": { "default": 1, "enum": [ 1, 3, 6, 12 ], "type": "integer" }, "user_count": { "type": "integer" } }, "required": [ "id", "actor_id", "request_id", "plan", "plan_name", "currency", "price_version", "term_months", "mode", "start_mode", "reason", "user_count", "tenant_count", "created_at" ], "type": "object" }, "PlanGiftCancellation": { "additionalProperties": false, "properties": { "cancelled": { "type": "boolean" } }, "required": [ "cancelled" ], "type": "object" }, "PlanGiftInput": { "additionalProperties": false, "properties": { "currency": { "maxLength": 3, "minLength": 3, "type": "string" }, "fingerprint": { "maxLength": 64, "minLength": 64, "type": "string" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "plan": { "type": "string" }, "price_version": { "type": "string" }, "reason": { "maxLength": 500, "minLength": 1, "type": "string" }, "request_id": { "maxLength": 80, "minLength": 1, "type": "string" }, "start_mode": { "default": "after_current", "enum": [ "after_current", "immediate" ], "type": "string" }, "term_months": { "default": 1, "enum": [ 1, 3, 6, 12 ], "type": "integer" }, "user_ids": { "items": { "format": "uuid", "type": "string" }, "maxItems": 100, "minItems": 1, "type": "array", "uniqueItems": true } }, "required": [ "user_ids", "term_months", "mode", "start_mode", "reason", "request_id", "fingerprint" ], "type": "object" }, "PlanGiftList": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/PlanGiftRow" }, "type": "array" }, "total": { "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "PlanGiftPreview": { "additionalProperties": false, "properties": { "fingerprint": { "type": "string" }, "items": { "items": { "$ref": "#/components/schemas/PlanGiftTarget" }, "type": "array" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "plan_name": { "type": "string" }, "start_mode": { "default": "after_current", "enum": [ "after_current", "immediate" ], "type": "string" }, "tenant_count": { "type": "integer" }, "term_months": { "default": 1, "enum": [ 1, 3, 6, 12 ], "type": "integer" }, "user_count": { "type": "integer" }, "value_cents": { "type": "integer" } }, "required": [ "fingerprint", "plan_name", "value_cents", "user_count", "tenant_count", "mode", "term_months", "start_mode", "items" ], "type": "object" }, "PlanGiftPreviewInput": { "additionalProperties": false, "properties": { "currency": { "maxLength": 3, "minLength": 3, "type": "string" }, "fingerprint": { "maxLength": 64, "minLength": 64, "type": "string" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "plan": { "type": "string" }, "price_version": { "type": "string" }, "reason": { "maxLength": 500, "minLength": 1, "type": "string" }, "request_id": { "maxLength": 80, "minLength": 1, "type": "string" }, "start_mode": { "default": "after_current", "enum": [ "after_current", "immediate" ], "type": "string" }, "term_months": { "default": 1, "enum": [ 1, 3, 6, 12 ], "type": "integer" }, "user_ids": { "items": { "format": "uuid", "type": "string" }, "maxItems": 100, "minItems": 1, "type": "array", "uniqueItems": true } }, "required": [ "user_ids", "mode", "reason" ], "type": "object" }, "PlanGiftResult": { "additionalProperties": false, "properties": { "batch": { "$ref": "#/components/schemas/PlanGiftBatch" }, "items": { "items": { "$ref": "#/components/schemas/PlanGift" }, "type": "array" } }, "required": [ "batch", "items" ], "type": "object" }, "PlanGiftRow": { "additionalProperties": false, "properties": { "actor_email": { "type": "string" }, "batch_id": { "format": "uuid", "type": "string" }, "cancel_reason": { "type": "string" }, "cancelled_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "cancelled_by": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "currency": { "type": "string" }, "email": { "type": "string" }, "ends_at": { "format": "date-time", "type": "string" }, "id": { "format": "uuid", "type": "string" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "plan": { "type": "string" }, "plan_name": { "type": "string" }, "purchase_id": { "format": "uuid", "type": "string" }, "reason": { "maxLength": 500, "minLength": 1, "type": "string" }, "starts_at": { "format": "date-time", "type": "string" }, "status": { "enum": [ "granted", "cancelled" ], "type": "string" }, "tenant_id": { "format": "uuid", "type": "string" }, "tenant_name": { "type": "string" }, "term_months": { "default": 1, "enum": [ 1, 3, 6, 12 ], "type": "integer" }, "user_id": { "format": "uuid", "type": "string" }, "value_cents": { "type": "integer" } }, "required": [ "id", "batch_id", "tenant_id", "user_id", "purchase_id", "value_cents", "status", "starts_at", "ends_at", "created_at", "cancelled_at" ], "type": "object" }, "PlanGiftTarget": { "additionalProperties": false, "properties": { "currency": { "type": "string" }, "email": { "type": "string" }, "ends_at": { "format": "date-time", "type": "string" }, "plan": { "type": "string" }, "plan_name": { "type": "string" }, "previous_end": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "price_version": { "type": "string" }, "starts_at": { "format": "date-time", "type": "string" }, "tenant_id": { "format": "uuid", "type": "string" }, "tenant_name": { "type": "string" }, "user_id": { "format": "uuid", "type": "string" }, "value_cents": { "type": "integer" } }, "required": [ "user_id", "email", "tenant_id", "tenant_name", "starts_at", "ends_at", "previous_end", "plan", "plan_name", "currency", "price_version", "value_cents" ], "type": "object" }, "PlanInput": { "additionalProperties": false, "properties": { "api_hard_limit": { "type": "boolean" }, "api_unit_amount": { "description": "Desimal nonnegatif per panggilan API berhasil, maksimal enam tempat", "type": "string" }, "base_amount": { "description": "Desimal nonnegatif; maksimal dua tempat", "type": "string" }, "currency": { "description": "Harus dikonfigurasi; penawaran katalog EUR dinonaktifkan", "pattern": "^[A-Z]{3}$", "type": "string" }, "description": { "maxLength": 1000, "type": "string" }, "enabled": { "type": "boolean" }, "expected_version": { "description": "Versi saat ini; kosong saat membuat", "type": "string" }, "hard_limit": { "type": "boolean" }, "included_api_calls": { "description": "null = tak terbatas; 0 = tidak ada panggilan berhasil yang disertakan", "maximum": 1000000000000, "minimum": 0, "type": [ "integer", "null" ] }, "included_devices": { "maximum": 1000000000, "minimum": 0, "type": "integer" }, "name": { "maxLength": 120, "minLength": 1, "type": "string" }, "plan": { "pattern": "^[a-z][a-z0-9_-]{0,63}$", "type": "string" }, "public": { "type": "boolean" }, "renewal_only": { "description": "Pelanggan berbayar atau penerima hadiah yang sudah ada dapat memperpanjang di muka atau setelah kedaluwarsa dalam lingkungan dan mata uang yang sama. Tersembunyi dari pembelian publik baru.", "type": "boolean" }, "sort_order": { "maximum": 10000, "minimum": 0, "type": "integer" }, "terms": { "description": "Tepat satu entri untuk 1, 3, 6, dan 12 bulan, masing-masing dengan ketersediaan dan harga totalnya sendiri.", "items": { "$ref": "#/components/schemas/PlanTermInput" }, "maxItems": 4, "minItems": 4, "type": "array" }, "unit_amount": { "description": "Desimal nonnegatif; maksimal enam tempat", "type": "string" } }, "required": [ "plan", "currency", "name", "base_amount", "unit_amount" ], "type": "object" }, "PlanList": { "additionalProperties": false, "properties": { "billing_unit": { "type": "string" }, "currencies": { "items": { "pattern": "^[A-Z]{3}$", "type": "string" }, "type": "array" }, "default_plan": { "anyOf": [ { "$ref": "#/components/schemas/Price" }, { "type": "null" } ] }, "items": { "items": { "$ref": "#/components/schemas/Price" }, "type": "array" }, "maximum_cents": { "type": "integer" }, "minimum_cents": { "type": "integer" }, "payment_channels": { "description": "Konfigurasi kanal pembayaran yang tersedia. Tampilkan hanya kanal aktif yang cocok dengan lingkungan penagihan aktif dan mata uang pembelian.", "items": { "$ref": "#/components/schemas/PaymentChannel" }, "type": "array" }, "paypal_enabled": { "type": "boolean" }, "sandbox": { "type": "boolean" }, "timezone": { "type": "string" } }, "required": [], "type": "object" }, "PlanPurchase": { "additionalProperties": false, "properties": { "api_calls": { "description": "Untuk PurchaseList.active: panggilan berhasil pada bulan kuota saat ini. Item historis berisi total sepanjang masa.", "type": "integer" }, "api_hard_limit": { "description": "Apakah panggilan runtime berhenti pada batas jatah API.", "type": "boolean" }, "api_overage_cents": { "description": "Bulan kuota saat ini dalam tampilan aktif; biaya kelebihan API sepanjang masa dalam item historis.", "type": "integer" }, "api_unit_micros": { "description": "Harga per kelebihan panggilan runtime dalam sepersejuta.", "minimum": 0, "type": "integer" }, "base_cents": { "description": "Biaya awal aktual untuk seluruh kontrak; nol untuk hadiah. Tampilan peningkatan efektif aktif berisi harga target lengkap dengan durasi yang cocok.", "type": "integer" }, "cancelled_at": { "anyOf": [ { "description": "Stempel waktu pembatalan kontrak, atau null.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu pembatalan kontrak, atau null.", "type": "null" } ], "description": "Stempel waktu pembatalan kontrak, atau null." }, "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "currency": { "description": "Kode mata uang huruf besar tiga huruf, seperti USD.", "pattern": "^[A-Z]{3}$", "type": "string" }, "current_cycle_index": { "description": "Indeks siklus jatah saat ini.", "maximum": 11, "minimum": 0, "type": "integer" }, "current_upgrade_id": { "description": "Kosong sebelum peningkatan. Selain itu menunjuk ke PlanUpgrade terbaru yang diterapkan. Respons aktif mencakup snapshot paket efektifnya, sementara pembelian historis mempertahankan harga penjualan asli.", "type": "string" }, "cycle_ends_at": { "description": "Akhir siklus jatah saat ini, UTC.", "format": "date-time", "type": "string" }, "cycle_starts_at": { "description": "Awal siklus jatah saat ini, UTC.", "format": "date-time", "type": "string" }, "effective_included_devices": { "description": "Jatah perangkat setelah peningkatan diterapkan. Snapshot pembelian asli tetap tidak berubah.", "minimum": 0, "type": "integer" }, "effective_plan": { "description": "Hak saat ini setelah overlay peningkatan eksplisit. Daftar pembelian mempertahankan plan/base_cents asli untuk riwayat tunai; gunakan bidang ini untuk menampilkan tingkat yang efektif saat ini.", "type": "string" }, "effective_plan_name": { "description": "Hak saat ini setelah overlay peningkatan eksplisit. Daftar pembelian mempertahankan plan/base_cents asli untuk riwayat tunai; gunakan bidang ini untuk menampilkan tingkat yang efektif saat ini.", "type": "string" }, "ends_at": { "anyOf": [ { "description": "Stempel waktu akhir paket atau siklus, UTC; dapat null sebelum aktivasi.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu akhir paket atau siklus, UTC; dapat null sebelum aktivasi.", "type": "null" } ], "description": "Stempel waktu akhir paket atau siklus, UTC; dapat null sebelum aktivasi." }, "entitlement_cents": { "description": "Nilai manfaat paket efektif saat ini untuk kredit peningkatan, dalam sen mata uang. Paket hadiah 99 USD memiliki 9900 sen manfaat meskipun pembayaran base_cents aslinya nol. Nilai ini bukan uang tunai yang dapat dikembalikan. Diisi pada tampilan paket aktif.", "minimum": 0, "type": "integer" }, "gift_batch_id": { "description": "Pengenal batch hadiah; kosong untuk pembelian biasa.", "type": "string" }, "gift_follows_current": { "default": false, "description": "Menunjukkan hadiah yang diterbitkan dari tingkat pelanggan saat ini. Hadiah mempertahankan nilai hak asli dan pembayaran tunai nol. Peningkatan seluruh cakupan yang eksplisit menerapkan overlay hak terpisah pada setiap hadiah yang belum kedaluwarsa dan mempertahankan catatan hadiah asli dengan tunai nol.", "type": "boolean" }, "hard_limit": { "description": "Apakah perangkat baru yang dapat ditagih ditolak pada batas jatah.", "type": "boolean" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "included_api_calls": { "description": "null = tak terbatas; 0 = tidak ada panggilan berhasil yang disertakan", "maximum": 1000000000000, "minimum": 0, "type": [ "integer", "null" ] }, "included_devices": { "description": "Jatah perangkat aktif yang disertakan.", "type": "integer" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "sandbox", "live" ], "type": "string" }, "overage_cents": { "description": "Bulan kuota saat ini dalam tampilan aktif; biaya kelebihan perangkat sepanjang masa dalam item historis.", "type": "integer" }, "plan": { "description": "Pengenal paket penagihan stabil dari katalog yang diterbitkan.", "pattern": "^[a-z][a-z0-9_-]{0,63}$", "type": "string" }, "plan_name": { "description": "Nama tampilan paket.", "type": "string" }, "price_version": { "description": "Revisi harga yang dibekukan; input usang dapat menyebabkan PLAN_VERSION_CONFLICT.", "type": "string" }, "refunded_cents": { "description": "Jumlah kumulatif yang dikembalikan dalam seperseratus.", "type": "integer" }, "renewal": { "description": "Apakah ini kontrak perpanjangan.", "type": "boolean" }, "renewal_of": { "description": "ID paket berbayar atau hadiah sebelumnya. Mempertahankan rantai perpanjangan dan riwayat pembelian asli.", "type": "string" }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "type": "string" }, "service_credit_basis_cents": { "description": "Dasar jumlah dalam seperseratus untuk perhitungan kredit layanan.", "type": "integer" }, "service_credit_basis_seconds": { "description": "Dasar waktu dalam detik untuk perhitungan kredit layanan.", "type": "integer" }, "source": { "description": "Sumber hak, seperti purchase atau gift.", "enum": [ "purchase", "gift", "auto_renewal" ], "type": "string" }, "starts_at": { "anyOf": [ { "description": "Stempel waktu mulai paket atau siklus, UTC.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu mulai paket atau siklus, UTC.", "type": "null" } ], "description": "Stempel waktu mulai paket atau siklus, UTC." }, "status": { "description": "Status resource saat ini; lihat enum dan catatan operasi.", "enum": [ "pending", "active", "cancelled", "expired" ], "type": "string" }, "term_months": { "default": 1, "description": "Jumlah bulan dalam jangka waktu yang dibeli.", "enum": [ 1, 3, 6, 12 ], "type": "integer" }, "total_api_calls": { "description": "Panggilan runtime kumulatif sepanjang kontrak.", "type": "integer" }, "total_api_overage_cents": { "description": "Kelebihan API kontrak kumulatif dalam seperseratus.", "type": "integer" }, "total_device_overage_cents": { "description": "Kelebihan perangkat kontrak kumulatif dalam seperseratus.", "type": "integer" }, "unit_micros": { "description": "Harga per kelebihan perangkat aktif dalam sepersejuta.", "type": "integer" } }, "required": [], "type": "object" }, "PlanTermInput": { "additionalProperties": false, "properties": { "amount": { "description": "Total durasi nonnegatif; maksimal dua angka desimal. Jumlah satu bulan harus sama dengan base_amount.", "type": "string" }, "enabled": { "type": "boolean" }, "months": { "default": 1, "enum": [ 1, 3, 6, 12 ], "type": "integer" } }, "required": [ "months", "enabled", "amount" ], "type": "object" }, "PlanTermPrice": { "additionalProperties": false, "properties": { "base_cents": { "description": "Total biaya untuk durasi yang dipilih, dalam sen mata uang. Kuota bulanan tidak dikalikan dengan durasi ini.", "minimum": 0, "type": "integer" }, "enabled": { "description": "Apakah endpoint webhook diaktifkan.", "type": "boolean" }, "months": { "default": 1, "description": "Jumlah bulan dalam jangka waktu pembelian.", "enum": [ 1, 3, 6, 12 ], "type": "integer" } }, "required": [ "months", "enabled", "base_cents" ], "type": "object" }, "PlanUpgrade": { "additionalProperties": false, "properties": { "amount_cents": { "description": "Pembayaran gabungan untuk setiap item dalam parts. Ditagih satu kali secara atomik. Bidang proration lain pada parent hanya menjelaskan periode saat ini; periksa parts untuk nilai asli, nilai target, detik tersisa, dan selisih individual setiap periode.", "type": "integer" }, "api_hard_limit": { "description": "Apakah panggilan runtime berhenti pada batas jatah API.", "type": "boolean" }, "api_unit_micros": { "description": "Tarif kelebihan API baru dalam sepersejuta mata uang.", "type": "integer" }, "applied_at": { "anyOf": [ { "description": "Waktu peningkatan berlaku, atau null.", "format": "date-time", "type": "string" }, { "description": "Waktu peningkatan berlaku, atau null.", "type": "null" } ], "description": "Waktu peningkatan berlaku, atau null." }, "base_cents": { "description": "Harga bulanan target dalam sen, bukan jumlah yang harus dibayar sekarang.", "type": "integer" }, "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "currency": { "description": "Mata uang yang sama dengan paket saat ini.", "type": "string" }, "cycle_seconds": { "description": "Panjang siklus pembelian asli dalam detik.", "type": "integer" }, "ends_at": { "description": "Stempel waktu akhir paket atau siklus, UTC; dapat null sebelum aktivasi.", "format": "date-time", "type": "string" }, "expires_at": { "description": "15 menit setelah pembuatan atau kedaluwarsa paket asli, mana yang lebih dahulu.", "format": "date-time", "type": "string" }, "hard_limit": { "description": "Apakah perangkat baru yang dapat ditagih ditolak pada batas jatah.", "type": "boolean" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "included_api_calls": { "anyOf": [ { "description": "Total jatah API untuk siklus yang ada. Null berarti tak terbatas. Panggilan sebelumnya tetap dihitung.", "type": "integer" }, { "description": "Panggilan runtime berhasil yang disertakan; null berarti tak terbatas dan 0 berarti tidak ada yang disertakan.", "type": "null" } ], "description": "Panggilan runtime berhasil yang disertakan; null berarti tak terbatas dan 0 berarti tidak ada yang disertakan." }, "included_devices": { "description": "Total jatah untuk siklus yang ada; penggunaan perangkat sebelumnya tetap dihitung.", "type": "integer" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "sandbox", "live" ], "type": "string" }, "parent_id": { "description": "Overlay hak internal yang diterapkan menunjuk ke satu penagihan parent. Catatan anak ini dikecualikan dari riwayat peningkatan pelanggan dan jumlah penjualan.", "format": "uuid", "type": "string" }, "parts": { "description": "Semua periode berbayar/hadiah saat ini dan masa depan yang belum kedaluwarsa, menurut urutan tanggal. Peningkatan seluruh cakupan wajib; tidak ada subset periode yang dapat dipilih.", "items": { "$ref": "#/components/schemas/UpgradePart" }, "type": "array" }, "plan": { "description": "Pengenal paket penagihan stabil dari katalog yang diterbitkan.", "type": "string" }, "plan_name": { "description": "Nama tampilan paket.", "type": "string" }, "previous_base_cents": { "description": "Harga bulanan efektif saat ini dalam sen.", "type": "integer" }, "previous_plan_name": { "description": "Nama tampilan paket sebelum peningkatan.", "type": "string" }, "previous_upgrade_id": { "description": "ID peningkatan sebelumnya, atau kosong untuk peningkatan pertama. Digunakan untuk menolak penawaran usang.", "type": "string" }, "price_version": { "description": "Versi harga target yang dibekukan.", "type": "string" }, "purchase_id": { "description": "UUID pembelian paket terkait.", "format": "uuid", "type": "string" }, "remaining_seconds": { "description": "Detik tersisa saat penawaran dibuat, dibulatkan ke atas.", "type": "integer" }, "request_id": { "description": "Kunci stabil yang dibuat klien. Penggunaan ulang dengan parameter penawaran berbeda mengembalikan 409.", "type": "string" }, "status": { "description": "Status resource saat ini; lihat enum dan catatan operasi.", "enum": [ "pending", "applied", "expired" ], "type": "string" }, "unit_micros": { "description": "Tarif kelebihan per perangkat yang baru dalam sepersejuta mata uang.", "type": "integer" } }, "required": [ "id", "request_id", "mode", "purchase_id", "previous_upgrade_id", "plan", "plan_name", "previous_plan_name", "currency", "price_version", "previous_base_cents", "base_cents", "amount_cents", "included_devices", "unit_micros", "hard_limit", "included_api_calls", "api_unit_micros", "api_hard_limit", "remaining_seconds", "cycle_seconds", "ends_at", "expires_at", "status", "created_at", "applied_at" ], "type": "object" }, "PlatformOperation": { "additionalProperties": false, "properties": { "action": { "type": "string" }, "actor_email": { "type": "string" }, "actor_id": { "format": "uuid", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "details": { "description": "String JSON yang hanya berisi perubahan administratif eksplisit; tidak pernah kata sandi, token, atau kredensial pembayaran.", "type": "string" }, "id": { "format": "uuid", "type": "string" }, "reason": { "maxLength": 500, "minLength": 1, "type": "string" }, "request_id": { "type": "string" }, "resource_id": { "type": "string" }, "tenant_id": { "type": "string" }, "user_email": { "type": "string" }, "user_id": { "type": "string" } }, "required": [ "id", "actor_id", "action", "user_id", "tenant_id", "resource_id", "reason", "details", "request_id", "created_at", "actor_email", "user_email" ], "type": "object" }, "PlatformOperationList": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/PlatformOperation" }, "type": "array" }, "total": { "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "PlatformOverview": { "additionalProperties": false, "properties": { "at": { "format": "date-time", "type": "string" }, "counts": { "additionalProperties": false, "properties": { "active_packages": { "type": "integer" }, "active_workspaces": { "type": "integer" }, "disabled_users": { "type": "integer" }, "enabled_plans": { "type": "integer" }, "expiring_packages": { "type": "integer" }, "failed_mail": { "type": "integer" }, "gift_packages": { "type": "integer" }, "new_users": { "type": "integer" }, "suspended_workspaces": { "type": "integer" }, "users": { "type": "integer" }, "verified_users": { "type": "integer" } }, "required": [ "users", "verified_users", "disabled_users", "new_users", "active_workspaces", "suspended_workspaces", "active_packages", "expiring_packages", "gift_packages", "failed_mail", "enabled_plans" ], "type": "object" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "paypal_enabled": { "type": "boolean" } }, "required": [ "counts", "mode", "paypal_enabled", "at" ], "type": "object" }, "PlatformReason": { "additionalProperties": false, "properties": { "reason": { "maxLength": 500, "minLength": 1, "type": "string" } }, "required": [ "reason" ], "type": "object" }, "PlatformRevocation": { "additionalProperties": false, "properties": { "revoked": { "type": "boolean" } }, "required": [ "revoked" ], "type": "object" }, "PlatformUser": { "additionalProperties": false, "properties": { "admin_note": { "description": "Catatan platform privat. Bidang profil pelanggan tetap tidak berubah.", "maxLength": 2000, "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "email": { "format": "email", "type": "string" }, "email_verified_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "id": { "format": "uuid", "type": "string" }, "is_platform_admin": { "type": "boolean" }, "last_login_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" }, "note_version": { "type": "string" }, "role": { "enum": [ "owner", "read_only" ], "type": "string" }, "status": { "enum": [ "active", "disabled" ], "type": "string" }, "tenant_id": { "format": "uuid", "type": "string" }, "tenant_name": { "type": "string" }, "tenant_status": { "enum": [ "active", "suspended" ], "type": "string" }, "tenant_updated_at": { "format": "date-time", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "id", "tenant_id", "tenant_name", "tenant_status", "tenant_updated_at", "email", "name", "role", "status", "is_platform_admin", "email_verified_at", "created_at", "updated_at", "last_login_at", "admin_note", "note_version" ], "type": "object" }, "PlatformUserDetail": { "additionalProperties": false, "properties": { "counts": { "additionalProperties": false, "properties": { "licenses": { "type": "integer" }, "products": { "type": "integer" }, "users": { "type": "integer" } }, "required": [ "users", "products", "licenses" ], "type": "object" }, "payments": { "items": { "additionalProperties": false, "properties": { "currency": { "type": "string" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "paid_cents": { "type": "integer" }, "refunded_cents": { "type": "integer" } }, "required": [ "mode", "currency", "paid_cents", "refunded_cents" ], "type": "object" }, "type": "array" }, "purchases": { "items": { "$ref": "#/components/schemas/PlanPurchase" }, "type": "array" }, "user": { "$ref": "#/components/schemas/PlatformUser" }, "wallets": { "items": { "$ref": "#/components/schemas/Wallet" }, "type": "array" } }, "required": [ "user", "counts", "wallets", "purchases", "payments" ], "type": "object" }, "PlatformUserList": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/PlatformUser" }, "type": "array" }, "total": { "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "PlatformUserUpdate": { "additionalProperties": false, "anyOf": [ { "required": [ "status", "expected_updated_at" ] }, { "required": [ "admin_note", "expected_note_version" ] } ], "properties": { "admin_note": { "maxLength": 2000, "type": "string" }, "expected_note_version": { "type": "string" }, "expected_updated_at": { "format": "date-time", "type": "string" }, "reason": { "maxLength": 500, "minLength": 1, "type": "string" }, "status": { "enum": [ "active", "disabled" ], "type": "string" } }, "required": [ "reason" ], "type": "object" }, "PlatformWorkspaceStatus": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "type": "string" }, "status": { "enum": [ "active", "suspended" ], "type": "string" } }, "required": [ "id", "status" ], "type": "object" }, "PlatformWorkspaceUpdate": { "additionalProperties": false, "properties": { "expected_updated_at": { "format": "date-time", "type": "string" }, "reason": { "maxLength": 500, "minLength": 1, "type": "string" }, "status": { "enum": [ "active", "suspended" ], "type": "string" } }, "required": [ "status", "reason", "expected_updated_at" ], "type": "object" }, "Policy": { "additionalProperties": false, "example": { "created_at": "2026-10-18T00:00:00Z", "features": [ "export" ], "heartbeat_seconds": 600, "id": "22222222-2222-4222-8222-222222222222", "max_devices": 1, "mode": "timed", "name": "One device", "offline_mode": "limited", "offline_seconds": 86400, "product_id": "11111111-1111-4111-8111-111111111111", "updated_at": "2026-10-18T00:00:00Z", "version": 1 }, "properties": { "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "features": { "description": "Hingga 32 pengenal fitur yang berbeda, masing-masing 1–64 huruf ASCII, angka, titik, tanda hubung, atau garis bawah.", "items": { "pattern": "^[A-Za-z0-9_.-]{1,64}$", "type": "string" }, "maxItems": 32, "type": "array", "uniqueItems": true }, "heartbeat_seconds": { "anyOf": [ { "const": 0, "description": "Interval heartbeat dalam detik: 0 menonaktifkannya; selain itu 600–86400. Jika dihilangkan menggunakan default server; independen dari jatah offline." }, { "description": "Interval heartbeat dalam detik: 0 menonaktifkannya; selain itu 600–86400. Jika dihilangkan menggunakan default server; independen dari jatah offline.", "maximum": 86400, "minimum": 600, "type": "integer" } ], "description": "Interval heartbeat saat online, dalam detik. 0 menonaktifkan heartbeat berkala. Jatah offline dikonfigurasi terpisah.", "type": "integer" }, "id": { "description": "UUID kebijakan, digunakan sebagai policy_id saat menerbitkan lisensi.", "format": "uuid", "type": "string" }, "max_devices": { "description": "Maksimum perangkat bersamaan atau kursi floating per lisensi.", "type": "integer" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "perpetual", "timed", "trial" ], "type": "string" }, "name": { "description": "Nama yang dapat dibaca manusia; lihat batas panjang.", "maxLength": 120, "minLength": 1, "type": "string" }, "offline_mode": { "description": "limited: offline terbatas waktu; none: tanpa penggunaan offline; permanent: tanpa batas waktu offline tambahan, tetapi kedaluwarsa lisensi tetap berlaku.", "enum": [ "limited", "none", "permanent" ], "type": "string" }, "offline_seconds": { "description": "Detik offline yang diizinkan: 1–31536000 untuk limited, 0 untuk none/permanent. Ini bukan interval heartbeat. Saat heartbeat aktif, kebijakan offline terbatas yang baru harus memenuhi offline_seconds \u003e= 3 × heartbeat_seconds; masa sewa kursi mengambang juga harus mencakup setidaknya tiga interval heartbeat.", "maximum": 31536000, "minimum": 0, "type": "integer" }, "product_id": { "description": "UUID produk di ruang kerja saat ini.", "format": "uuid", "type": "string" }, "updated_at": { "description": "Stempel waktu pembaruan terakhir dalam UTC.", "format": "date-time", "type": "string" }, "version": { "description": "Revisi kebijakan bertambah pada setiap edit. Saat diterapkan ke lisensi yang ada, revisi memeriksa bahwa pratinjau masih mutakhir.", "type": "integer" } }, "required": [ "id", "product_id", "mode", "version" ], "type": "object" }, "PolicyCapabilities": { "additionalProperties": false, "properties": { "allow_vm": { "description": "Apakah mesin virtual diizinkan.", "type": "boolean" }, "device_match": { "description": "Pencocokan identitas system atau pencocokan identitas hardware.", "enum": [ "system", "hardware" ], "type": "string" }, "license_model": { "description": "Pengikatan perangkat node_locked atau kursi floating.", "enum": [ "node_locked", "floating" ], "type": "string" }, "maintenance_days": { "description": "Hari pemeliharaan sejak aktivasi pertama; 0 berarti tidak ada batas akhir pemeliharaan.", "maximum": 36500, "minimum": 0, "type": "integer" }, "max_version": { "description": "Versi aplikasi maksimum yang diizinkan; kosong berarti tidak ada batas atas.", "type": "string" }, "meter_rules": { "description": "Aturan pengukuran fitur; kosong berarti tidak ada yang dikonfigurasi.", "items": { "additionalProperties": false, "properties": { "allow_overage": { "description": "Apakah kelebihan penggunaan fitur diizinkan.", "type": "boolean" }, "feature": { "description": "Pengenal fitur terukur, yang harus ada dalam fitur kebijakan.", "pattern": "^[A-Za-z0-9_.-]{1,64}$", "type": "string" }, "limit": { "description": "Jumlah penggunaan fitur yang disertakan per periode pengukuran (bukan batas paginasi).", "maximum": 1000000000000, "minimum": 0, "type": "integer" }, "max_overage": { "description": "Kelebihan penggunaan maksimum yang diizinkan; dinonaktifkan ketika allow_overage bernilai false.", "maximum": 1000000000000, "minimum": 0, "type": "integer" }, "period": { "description": "Snapshot penagihan bulanan UTC default; aturan meter menggunakan month/day/lifetime dan baris penggunaan menggunakan kunci periode konkret.", "enum": [ "month", "day", "lifetime" ], "type": "string" } }, "required": [ "feature", "limit", "period" ], "type": "object" }, "maxItems": 32, "type": "array" }, "min_version": { "description": "Versi aplikasi minimum yang diizinkan; kosong berarti tidak ada batas bawah.", "type": "string" }, "policy_id": { "description": "UUID kebijakan; harus milik produk saat penerbitan.", "format": "uuid", "type": "string" }, "policy_version": { "description": "Revisi kebijakan; kirim nilai saat ini saat mengedit kemampuan lengkap untuk mencegah penulisan usang.", "type": "integer" }, "product_id": { "description": "UUID produk di ruang kerja saat ini.", "format": "uuid", "type": "string" }, "require_hardware": { "description": "Apakah identitas hardware yang dapat digunakan diwajibkan.", "type": "boolean" }, "self_release_limit": { "description": "Jumlah pelepasan mandiri yang diizinkan per 30 hari bergulir, 0–100; 0 menonaktifkannya.", "maximum": 100, "minimum": 0, "type": "integer" }, "session_seconds": { "description": "Detik lease kursi floating tanpa heartbeat, 20–86400; harus memenuhi batasan runtime kebijakan.", "maximum": 86400, "minimum": 20, "type": "integer" }, "updated_at": { "description": "Stempel waktu pembaruan terakhir dalam UTC.", "format": "date-time", "type": "string" } }, "required": [], "type": "object" }, "PolicyCapabilitiesInput": { "additionalProperties": false, "description": "Menentukan mode penerbitan, batas perangkat/kursi, fitur, dan aturan runtime. Tidak ada durasi masa berlaku yang disimpan dalam kebijakan. policy_version diperlukan untuk mencegah edit usang.", "properties": { "allow_vm": { "description": "Apakah mesin virtual diizinkan.", "type": "boolean" }, "device_match": { "description": "Pencocokan identitas system atau pencocokan identitas hardware.", "enum": [ "system", "hardware" ], "type": "string" }, "features": { "description": "Hingga 32 pengenal fitur yang berbeda, masing-masing 1–64 huruf ASCII, angka, titik, tanda hubung, atau garis bawah.", "items": { "pattern": "^[A-Za-z0-9_.-]{1,64}$", "type": "string" }, "maxItems": 32, "type": "array", "uniqueItems": true }, "heartbeat_seconds": { "anyOf": [ { "const": 0, "description": "Interval heartbeat dalam detik: 0 menonaktifkannya; selain itu 600–86400. Jika dihilangkan menggunakan default server; independen dari jatah offline." }, { "description": "Interval heartbeat dalam detik: 0 menonaktifkannya; selain itu 600–86400. Jika dihilangkan menggunakan default server; independen dari jatah offline.", "maximum": 86400, "minimum": 600, "type": "integer" } ], "description": "0 secara eksplisit menonaktifkan heartbeat berkala; selain itu 600–86400 detik (minimum 10 menit). Independen dari jatah offline.", "type": "integer" }, "license_model": { "description": "Pengikatan perangkat node_locked atau kursi floating.", "enum": [ "node_locked", "floating" ], "type": "string" }, "maintenance_days": { "description": "Hari pemeliharaan sejak aktivasi pertama; 0 berarti tidak ada batas akhir pemeliharaan.", "maximum": 36500, "minimum": 0, "type": "integer" }, "max_devices": { "description": "Maksimum perangkat bersamaan atau kursi floating per lisensi.", "maximum": 10000, "minimum": 1, "type": "integer" }, "max_version": { "description": "Versi aplikasi maksimum yang diizinkan; kosong berarti tidak ada batas atas.", "type": "string" }, "meter_rules": { "description": "Aturan pengukuran fitur; kosong berarti tidak ada yang dikonfigurasi.", "items": { "additionalProperties": false, "properties": { "allow_overage": { "description": "Apakah kelebihan penggunaan fitur diizinkan.", "type": "boolean" }, "feature": { "description": "Pengenal fitur terukur, yang harus ada dalam fitur kebijakan.", "pattern": "^[A-Za-z0-9_.-]{1,64}$", "type": "string" }, "limit": { "description": "Jumlah penggunaan fitur yang disertakan per periode pengukuran (bukan batas paginasi).", "maximum": 1000000000000, "minimum": 0, "type": "integer" }, "max_overage": { "description": "Kelebihan penggunaan maksimum yang diizinkan; dinonaktifkan ketika allow_overage bernilai false.", "maximum": 1000000000000, "minimum": 0, "type": "integer" }, "period": { "description": "Snapshot penagihan bulanan UTC default; aturan meter menggunakan month/day/lifetime dan baris penggunaan menggunakan kunci periode konkret.", "enum": [ "month", "day", "lifetime" ], "type": "string" } }, "required": [ "feature", "limit", "period" ], "type": "object" }, "maxItems": 32, "type": "array" }, "min_version": { "description": "Versi aplikasi minimum yang diizinkan; kosong berarti tidak ada batas bawah.", "type": "string" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "perpetual", "timed", "trial" ], "type": "string" }, "name": { "description": "Nama yang dapat dibaca manusia; lihat batas panjang.", "maxLength": 120, "minLength": 1, "type": "string" }, "offline_mode": { "description": "Jatah offline limited, none, atau permanent; kedaluwarsa lisensi tetap berlaku.", "enum": [ "limited", "none", "permanent" ], "type": "string" }, "offline_seconds": { "description": "Limited: 1–31536000 detik dan setidaknya 3 × heartbeat_seconds saat heartbeat aktif; none/permanent: 0", "maximum": 31536000, "minimum": 0, "type": "integer" }, "policy_version": { "description": "Revisi kebijakan; kirim nilai saat ini saat mengedit kemampuan lengkap untuk mencegah penulisan usang.", "minimum": 1, "type": "integer" }, "require_hardware": { "description": "Apakah identitas hardware yang dapat digunakan diwajibkan.", "type": "boolean" }, "self_release_limit": { "description": "Jumlah pelepasan mandiri yang diizinkan per 30 hari bergulir, 0–100; 0 menonaktifkannya.", "maximum": 100, "minimum": 0, "type": "integer" }, "session_seconds": { "description": "Detik lease kursi floating tanpa heartbeat, 20–86400; harus memenuhi batasan runtime kebijakan.", "maximum": 86400, "minimum": 20, "type": "integer" } }, "required": [ "policy_version" ], "type": "object" }, "PolicyCreate": { "additionalProperties": false, "description": "Menentukan mode penerbitan, batas perangkat/kursi, fitur, dan aturan runtime. Tidak ada durasi masa berlaku yang disimpan dalam kebijakan. ", "properties": { "allow_vm": { "description": "Apakah mesin virtual diizinkan.", "type": "boolean" }, "device_match": { "description": "Pencocokan identitas system atau pencocokan identitas hardware.", "enum": [ "system", "hardware" ], "type": "string" }, "features": { "description": "Pengenal fitur yang diizinkan, misalnya [\"export\"]. Harus sesuai dengan argumen CheckFeature aplikasi Anda.", "items": { "pattern": "^[A-Za-z0-9_.-]{1,64}$", "type": "string" }, "maxItems": 32, "type": "array", "uniqueItems": true }, "heartbeat_seconds": { "anyOf": [ { "const": 0, "description": "Interval heartbeat dalam detik: 0 menonaktifkannya; selain itu 600–86400. Jika dihilangkan menggunakan default server; independen dari jatah offline." }, { "description": "Interval heartbeat dalam detik: 0 menonaktifkannya; selain itu 600–86400. Jika dihilangkan menggunakan default server; independen dari jatah offline.", "maximum": 86400, "minimum": 600, "type": "integer" } ], "description": "Interval heartbeat saat online, dalam detik. 0 menonaktifkan heartbeat berkala. Jatah offline dikonfigurasi terpisah.", "type": "integer" }, "license_model": { "description": "Pengikatan perangkat node_locked atau kursi floating.", "enum": [ "node_locked", "floating" ], "type": "string" }, "maintenance_days": { "description": "Hari pemeliharaan sejak aktivasi pertama; 0 berarti tidak ada batas akhir pemeliharaan.", "maximum": 36500, "minimum": 0, "type": "integer" }, "max_devices": { "description": "Batas perangkat per lisensi, 1–10000; dalam mode floating ini adalah batas kursi bersamaan.", "maximum": 10000, "minimum": 1, "type": "integer" }, "max_version": { "description": "Versi aplikasi maksimum yang diizinkan; kosong berarti tidak ada batas atas.", "type": "string" }, "meter_rules": { "description": "Aturan pengukuran fitur; kosong berarti tidak ada yang dikonfigurasi.", "items": { "additionalProperties": false, "properties": { "allow_overage": { "description": "Apakah kelebihan penggunaan fitur diizinkan.", "type": "boolean" }, "feature": { "description": "Pengenal fitur terukur, yang harus ada dalam fitur kebijakan.", "pattern": "^[A-Za-z0-9_.-]{1,64}$", "type": "string" }, "limit": { "description": "Jumlah penggunaan fitur yang disertakan per periode pengukuran (bukan batas paginasi).", "maximum": 1000000000000, "minimum": 0, "type": "integer" }, "max_overage": { "description": "Kelebihan penggunaan maksimum yang diizinkan; dinonaktifkan ketika allow_overage bernilai false.", "maximum": 1000000000000, "minimum": 0, "type": "integer" }, "period": { "description": "Snapshot penagihan bulanan UTC default; aturan meter menggunakan month/day/lifetime dan baris penggunaan menggunakan kunci periode konkret.", "enum": [ "month", "day", "lifetime" ], "type": "string" } }, "required": [ "feature", "limit", "period" ], "type": "object" }, "maxItems": 32, "type": "array" }, "min_version": { "description": "Versi aplikasi minimum yang diizinkan; kosong berarti tidak ada batas bawah.", "type": "string" }, "mode": { "description": "Jenis lisensi: perpetual, timed, atau trial. Ini bukan jenis langganan paket penagihan.", "enum": [ "perpetual", "timed", "trial" ], "type": "string" }, "name": { "description": "Nama kebijakan, misalnya Pro 30 hari.", "maxLength": 120, "minLength": 1, "type": "string" }, "offline_mode": { "description": "limited: offline terbatas waktu; none: tanpa penggunaan offline; permanent: tanpa batas waktu offline tambahan, tetapi kedaluwarsa lisensi tetap berlaku.", "enum": [ "limited", "none", "permanent" ], "type": "string" }, "offline_seconds": { "description": "Detik offline yang diizinkan: 1–31536000 untuk limited, 0 untuk none/permanent. Ini bukan interval heartbeat. Saat heartbeat aktif, kebijakan offline terbatas yang baru harus memenuhi offline_seconds \u003e= 3 × heartbeat_seconds; masa sewa kursi mengambang juga harus mencakup setidaknya tiga interval heartbeat.", "maximum": 31536000, "minimum": 0, "type": "integer" }, "product_id": { "description": "ID produk (UUID).", "format": "uuid", "type": "string" }, "require_hardware": { "description": "Apakah identitas hardware yang dapat digunakan diwajibkan.", "type": "boolean" }, "self_release_limit": { "description": "Jumlah pelepasan mandiri yang diizinkan per 30 hari bergulir, 0–100; 0 menonaktifkannya.", "maximum": 100, "minimum": 0, "type": "integer" }, "session_seconds": { "description": "Detik lease kursi floating tanpa heartbeat, 20–86400; harus memenuhi batasan runtime kebijakan.", "maximum": 86400, "minimum": 20, "type": "integer" } }, "required": [ "product_id", "name", "mode", "max_devices" ], "type": "object" }, "PolicyList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/Policy" }, "type": "array" }, "limit": { "description": "Ukuran halaman, default 25, rentang 1–100.", "type": "integer" }, "offset": { "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "type": "integer" }, "total": { "description": "Total catatan yang cocok, bukan panjang halaman saat ini.", "type": "integer" } }, "required": [ "items", "total", "limit", "offset" ], "type": "object" }, "PolicyPreview": { "additionalProperties": false, "properties": { "changes": { "description": "Perbandingan sebelum/sesudah per lisensi dan alasan pemblokiran.", "items": { "additionalProperties": false, "properties": { "active": { "description": "Flag kunci penandatanganan saat ini; dalam pratinjau kebijakan, jumlah perangkat/sesi aktif.", "type": "integer" }, "after": { "additionalProperties": false, "description": "Hak setelah menerapkan kebijakan target; masa berlaku tetap tidak berubah.", "properties": { "duration_days": { "description": "Hari per lisensi sejak aktivasi pertama. Wajib 1–36500 untuk penerbitan timed/trial; tidak ada/null untuk perpetual. Tidak pernah disimpan dalam kebijakan.", "type": [ "integer", "null" ] }, "expires_at": { "anyOf": [ { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "format": "date-time", "type": "string" }, { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "type": "null" } ], "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial." }, "features": { "description": "Hingga 32 pengenal fitur yang berbeda, masing-masing 1–64 huruf ASCII, angka, titik, tanda hubung, atau garis bawah.", "items": { "type": "string" }, "type": "array" }, "license_model": { "description": "Pengikatan perangkat node_locked atau kursi floating.", "enum": [ "node_locked", "floating" ], "type": "string" }, "maintenance_until": { "anyOf": [ { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "format": "date-time", "type": "string" }, { "description": "Batas pemeliharaan untuk rilis baru; dapat null sebelum aktivasi atau ketika tak terbatas.", "type": "null" } ], "description": "Batas pemeliharaan untuk rilis baru; dapat null sebelum aktivasi atau ketika tak terbatas." }, "max_devices": { "description": "Maksimum perangkat bersamaan atau kursi floating per lisensi.", "type": "integer" }, "max_version": { "description": "Versi aplikasi maksimum yang diizinkan; kosong berarti tidak ada batas atas.", "type": "string" }, "meter_rules": { "description": "Aturan pengukuran fitur; kosong berarti tidak ada yang dikonfigurasi.", "items": { "additionalProperties": false, "properties": { "allow_overage": { "description": "Apakah kelebihan penggunaan fitur diizinkan.", "type": "boolean" }, "feature": { "description": "Pengenal fitur terukur, yang harus ada dalam fitur kebijakan.", "pattern": "^[A-Za-z0-9_.-]{1,64}$", "type": "string" }, "limit": { "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 1000000000000, "minimum": 0, "type": "integer" }, "max_overage": { "description": "Kelebihan penggunaan maksimum yang diizinkan; dinonaktifkan ketika allow_overage bernilai false.", "maximum": 1000000000000, "minimum": 0, "type": "integer" }, "period": { "description": "Snapshot penagihan bulanan UTC default; aturan meter menggunakan month/day/lifetime dan baris penggunaan menggunakan kunci periode konkret.", "enum": [ "month", "day", "lifetime" ], "type": "string" } }, "required": [ "feature", "limit", "period" ], "type": "object" }, "maxItems": 32, "type": "array" }, "min_version": { "description": "Versi aplikasi minimum yang diizinkan; kosong berarti tidak ada batas bawah.", "type": "string" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "perpetual", "timed", "trial" ], "type": "string" } }, "required": [ "mode", "max_devices", "features", "expires_at", "duration_days", "license_model", "meter_rules", "maintenance_until", "min_version", "max_version" ], "type": "object" }, "before": { "additionalProperties": false, "description": "Hak yang diterbitkan saat ini dan masa berlaku lisensi.", "properties": { "capabilities": { "$ref": "#/components/schemas/LicenseCapabilities", "description": "Snapshot kemampuan lisensi." }, "duration_days": { "description": "Hari per lisensi sejak aktivasi pertama. Wajib 1–36500 untuk penerbitan timed/trial; tidak ada/null untuk perpetual. Tidak pernah disimpan dalam kebijakan.", "type": [ "integer", "null" ] }, "expires_at": { "anyOf": [ { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "format": "date-time", "type": "string" }, { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "type": "null" } ], "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial." }, "features": { "description": "Hingga 32 pengenal fitur yang berbeda, masing-masing 1–64 huruf ASCII, angka, titik, tanda hubung, atau garis bawah.", "items": { "type": "string" }, "type": "array" }, "max_devices": { "description": "Maksimum perangkat bersamaan atau kursi floating per lisensi.", "type": "integer" }, "meter_rules": { "description": "Aturan pengukuran fitur; kosong berarti tidak ada yang dikonfigurasi.", "items": { "additionalProperties": false, "properties": { "allow_overage": { "description": "Apakah kelebihan penggunaan fitur diizinkan.", "type": "boolean" }, "feature": { "description": "Pengenal fitur terukur, yang harus ada dalam fitur kebijakan.", "pattern": "^[A-Za-z0-9_.-]{1,64}$", "type": "string" }, "limit": { "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 1000000000000, "minimum": 0, "type": "integer" }, "max_overage": { "description": "Kelebihan penggunaan maksimum yang diizinkan; dinonaktifkan ketika allow_overage bernilai false.", "maximum": 1000000000000, "minimum": 0, "type": "integer" }, "period": { "description": "Snapshot penagihan bulanan UTC default; aturan meter menggunakan month/day/lifetime dan baris penggunaan menggunakan kunci periode konkret.", "enum": [ "month", "day", "lifetime" ], "type": "string" } }, "required": [ "feature", "limit", "period" ], "type": "object" }, "maxItems": 32, "type": "array" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "perpetual", "timed", "trial" ], "type": "string" } }, "required": [ "mode", "max_devices", "features", "expires_at", "duration_days", "capabilities", "meter_rules" ], "type": "object" }, "blocked_reason": { "description": "Alasan perubahan diblokir; kosong berarti tidak ada penghalang saat ini.", "type": "string" }, "customer": { "description": "Label pelanggan yang ditentukan vendor, berbeda dari email portal pelanggan.", "type": "string" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } }, "required": [ "id", "customer", "before", "after", "blocked_reason", "active" ], "type": "object" }, "type": "array" }, "expires_in": { "const": 600, "description": "Masa berlaku token pratinjau dalam detik, saat ini 600.", "type": "integer" }, "note": { "description": "Panduan tambahan untuk pengembang.", "type": "string" }, "policy_version": { "description": "Revisi kebijakan; kirim nilai saat ini saat mengedit kemampuan lengkap untuk mencegah penulisan usang.", "type": "integer" }, "preview_token": { "description": "Token konfirmasi pratinjau terenkripsi wajib untuk apply_policy; berlaku 600 detik dan dibatalkan oleh perubahan resource.", "type": "string" } }, "required": [ "changes", "policy_version", "preview_token", "expires_in", "note" ], "type": "object" }, "PolicySyncResult": { "additionalProperties": false, "properties": { "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "synced_licenses": { "description": "Jumlah lisensi terkait yang belum dicabut dan disinkronkan dalam transaksi yang sama.", "minimum": 0, "type": "integer" } }, "required": [ "id", "synced_licenses" ], "type": "object" }, "PolicyUpdate": { "additionalProperties": false, "description": "Menentukan mode penerbitan, batas perangkat/kursi, fitur, dan aturan runtime. Tidak ada durasi masa berlaku yang disimpan dalam kebijakan. ", "properties": { "features": { "description": "Hingga 32 pengenal fitur yang berbeda, masing-masing 1–64 huruf ASCII, angka, titik, tanda hubung, atau garis bawah.", "items": { "pattern": "^[A-Za-z0-9_.-]{1,64}$", "type": "string" }, "maxItems": 32, "type": "array", "uniqueItems": true }, "heartbeat_seconds": { "anyOf": [ { "const": 0, "description": "Interval heartbeat dalam detik: 0 menonaktifkannya; selain itu 600–86400. Jika dihilangkan menggunakan default server; independen dari jatah offline." }, { "description": "Interval heartbeat dalam detik: 0 menonaktifkannya; selain itu 600–86400. Jika dihilangkan menggunakan default server; independen dari jatah offline.", "maximum": 86400, "minimum": 600, "type": "integer" } ], "description": "0 secara eksplisit menonaktifkan heartbeat berkala; selain itu 600–86400 detik (minimum 10 menit). Independen dari jatah offline.", "type": "integer" }, "max_devices": { "description": "Maksimum perangkat bersamaan atau kursi floating per lisensi.", "maximum": 10000, "minimum": 1, "type": "integer" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "perpetual", "timed", "trial" ], "type": "string" }, "name": { "description": "Nama yang dapat dibaca manusia; lihat batas panjang.", "maxLength": 120, "minLength": 1, "type": "string" }, "offline_mode": { "description": "Jatah offline limited, none, atau permanent; kedaluwarsa lisensi tetap berlaku.", "enum": [ "limited", "none", "permanent" ], "type": "string" }, "offline_seconds": { "description": "Limited: 1–31536000 detik dan setidaknya 3 × heartbeat_seconds saat heartbeat aktif; none/permanent: 0", "maximum": 31536000, "minimum": 0, "type": "integer" } }, "required": [], "type": "object" }, "PreviewInput": { "additionalProperties": false, "properties": { "ids": { "description": "UUID lisensi berbeda yang akan diproses, 1–100.", "items": { "format": "uuid", "type": "string" }, "maxItems": 100, "minItems": 1, "type": "array", "uniqueItems": true }, "policy_id": { "description": "UUID kebijakan; harus milik produk saat penerbitan.", "format": "uuid", "type": "string" } }, "required": [ "policy_id", "ids" ], "type": "object" }, "Price": { "additionalProperties": false, "properties": { "api_hard_limit": { "description": "Apakah panggilan runtime berhenti pada batas jatah API.", "type": "boolean" }, "api_unit_micros": { "description": "Harga per kelebihan panggilan runtime dalam sepersejuta.", "minimum": 0, "type": "integer" }, "base_micros": { "description": "Biaya dasar dalam sepersejuta unit mata uang.", "type": "integer" }, "currency": { "description": "Kode mata uang huruf besar tiga huruf, seperti USD.", "type": "string" }, "description": { "description": "Deskripsi penawaran penagihan.", "type": "string" }, "enabled": { "description": "Apakah penawaran penagihan diaktifkan untuk dibeli.", "type": "boolean" }, "hard_limit": { "description": "Apakah perangkat baru yang dapat ditagih ditolak pada batas jatah.", "type": "boolean" }, "included_api_calls": { "description": "null = tak terbatas; 0 = tidak ada panggilan berhasil yang disertakan", "maximum": 1000000000000, "minimum": 0, "type": [ "integer", "null" ] }, "included_devices": { "description": "Jatah perangkat aktif yang disertakan.", "type": "integer" }, "name": { "description": "Nama tampilan penawaran penagihan.", "type": "string" }, "plan": { "description": "Pengenal paket penagihan stabil dari katalog yang diterbitkan.", "type": "string" }, "price_version": { "description": "Revisi harga yang dibekukan; input usang dapat menyebabkan PLAN_VERSION_CONFLICT.", "type": "string" }, "public": { "description": "Apakah penawaran penagihan tercantum secara publik.", "type": "boolean" }, "renewal_only": { "description": "Pelanggan berbayar atau penerima hadiah yang sudah ada dapat memperpanjang di muka atau setelah kedaluwarsa dalam lingkungan dan mata uang yang sama. Tersembunyi dari pembelian publik baru.", "type": "boolean" }, "sort_order": { "description": "Urutan tampilan penawaran penagihan.", "type": "integer" }, "terms": { "description": "Jangka waktu pembelian yang tersedia dan harganya.", "items": { "$ref": "#/components/schemas/PlanTermPrice" }, "type": "array" }, "unit_micros": { "description": "Harga per kelebihan perangkat aktif dalam sepersejuta.", "type": "integer" }, "updated_at": { "description": "Stempel waktu pembaruan terakhir dalam UTC.", "format": "date-time", "type": "string" } }, "required": [], "type": "object" }, "Product": { "additionalProperties": false, "example": { "created_at": "2026-10-18T00:00:00Z", "description": "Desktop reporting software", "id": "11111111-1111-4111-8111-111111111111", "name": "Report app", "status": "active", "updated_at": "2026-10-18T00:00:00Z" }, "properties": { "created_at": { "description": "Stempel waktu pembuatan, UTC ISO 8601.", "format": "date-time", "type": "string" }, "description": { "description": "Deskripsi produk.", "type": "string" }, "id": { "description": "UUID produk yang digunakan dalam konfigurasi SDK dan pembuatan kebijakan.", "format": "uuid", "type": "string" }, "name": { "description": "Nama produk.", "maxLength": 120, "minLength": 1, "type": "string" }, "status": { "description": "active mengizinkan aktivasi; disabled menolak permintaan lisensi runtime.", "enum": [ "active", "disabled" ], "type": "string" }, "updated_at": { "description": "Stempel waktu pembaruan terakhir, UTC ISO 8601.", "format": "date-time", "type": "string" } }, "required": [ "id", "name", "status" ], "type": "object" }, "ProductCreate": { "additionalProperties": false, "properties": { "description": { "description": "Deskripsi perangkat lunak opsional, hingga 1000 karakter.", "maxLength": 1000, "type": "string" }, "name": { "description": "Nama perangkat lunak, 1–120 karakter.", "maxLength": 120, "minLength": 1, "type": "string" } }, "required": [ "name" ], "type": "object" }, "ProductList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/Product" }, "type": "array" }, "limit": { "description": "Ukuran halaman, default 25, rentang 1–100.", "type": "integer" }, "offset": { "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "type": "integer" }, "total": { "description": "Total catatan yang cocok, bukan panjang halaman saat ini.", "type": "integer" } }, "required": [ "items", "total", "limit", "offset" ], "type": "object" }, "ProductUpdate": { "additionalProperties": false, "properties": { "description": { "description": "Deskripsi produk; boleh kosong.", "maxLength": 1000, "type": "string" }, "name": { "description": "Nama yang dapat dibaca manusia; lihat batas panjang.", "maxLength": 120, "minLength": 1, "type": "string" }, "status": { "description": "Status resource saat ini; lihat enum dan catatan operasi.", "enum": [ "active", "disabled" ], "type": "string" } }, "required": [], "type": "object" }, "ProviderRefund": { "additionalProperties": false, "properties": { "amount_cents": { "minimum": 0, "type": "integer" }, "attempted_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "attempts": { "minimum": 0, "type": "integer" }, "case_id": { "format": "uuid", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "currency": { "type": "string" }, "id": { "format": "uuid", "type": "string" }, "last_error": { "type": "string" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "order_id": { "format": "uuid", "type": "string" }, "provider": { "enum": [ "waffo", "paddle" ], "type": "string" }, "provider_refund_id": { "type": [ "string", "null" ] }, "reason": { "type": "string" }, "reserved": { "type": "boolean" }, "settled_cents": { "minimum": 0, "type": "integer" }, "status": { "enum": [ "created", "submitting", "pending", "unknown", "completed", "failed" ], "type": "string" }, "submitted_cents": { "minimum": 0, "type": "integer" }, "unapplied": { "type": "boolean" }, "updated_at": { "format": "date-time", "type": "string" } }, "type": "object" }, "PurchaseList": { "additionalProperties": false, "properties": { "active": { "anyOf": [ { "$ref": "#/components/schemas/PlanPurchase", "description": "Flag kunci penandatanganan saat ini; dalam pratinjau kebijakan, jumlah perangkat/sesi aktif." }, { "description": "Flag kunci penandatanganan saat ini; dalam pratinjau kebijakan, jumlah perangkat/sesi aktif.", "type": "null" } ], "description": "Kontrak paket pembelian efektif saat ini, atau null." }, "active_devices": { "description": "Hunian produk/perangkat terdaftar saat ini, independen dari riwayat penggunaan perangkat bulanan. Pendaftaran biasa tetap dihitung saat offline hingga dilepas. Sesi floating hanya dihitung selama lease valid dan dideduplikasi berdasarkan perangkat keras, dengan identitas perangkat sebagai cadangan. Pelepasan atau kedaluwarsa sesi floating terakhir mengembalikan kapasitas; pendaftaran valid berlanjut melewati batas bulan kuota. Pendaftaran uji coba SDK terisolasi dikecualikan.", "type": "integer" }, "coverage_ends_at": { "anyOf": [ { "description": "Akhir cakupan paket berbayar yang berkelanjutan, atau null.", "format": "date-time", "type": "string" }, { "description": "Akhir cakupan paket berbayar yang berkelanjutan, atau null.", "type": "null" } ], "description": "Akhir total cakupan prabayar, termasuk perpanjangan berbayar di muka dan hadiah terjadwal. Paket aktif tetap melaporkan periode kuota saat ini miliknya sendiri." }, "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/PlanPurchase" }, "type": "array" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "sandbox", "live" ], "type": "string" }, "renewal_package": { "anyOf": [ { "$ref": "#/components/schemas/PlanPurchase", "description": "Kontrak berbayar terbaru yang memenuhi syarat perpanjangan, atau null." }, { "description": "Kontrak berbayar terbaru yang memenuhi syarat perpanjangan, atau null.", "type": "null" } ], "description": "Cakupan berbayar atau hadiah terbaru, termasuk peningkatan yang diterapkan. Gunakan paket efektif dan mata uang ini untuk memilih perpanjangan manual atau otomatis. Null sampai paket dibuka." }, "total": { "description": "Total catatan yang cocok, bukan panjang halaman saat ini.", "type": "integer" } }, "required": [], "type": "object" }, "RechargeInput": { "additionalProperties": false, "description": "Tautkan purchase_id OR upgrade_id, jangan keduanya. Pembayaran yang dikonfirmasi mengkredit dompet dan menyelesaikan pembelian/peningkatan tersebut ketika penawarannya masih valid. Pembayaran peningkatan yang terlambat tetap berada di dompet.", "properties": { "amount": { "description": "Nilai isi ulang desimal, maksimal dua tempat", "type": "string" }, "currency": { "pattern": "^[A-Z]{3}$", "type": "string" }, "overage_accepted": { "description": "Otorisasi eksplisit terpisah untuk kelebihan penggunaan berbayar yang ditampilkan.", "type": "boolean" }, "policy_version": { "description": "Versi kebijakan tidak berubah yang saat ini diterbitkan. Wajib untuk tindakan yang dilindungi persetujuan setelah operator menerbitkan kebijakan, pada kedua lingkungan pembayaran.", "type": "string" }, "purchase_id": { "format": "uuid", "type": [ "string", "null" ] }, "request_id": { "maxLength": 80, "type": "string" }, "terms_accepted": { "description": "Persetujuan eksplisit yang secara default tidak dicentang.", "type": "boolean" }, "upgrade_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ] } }, "required": [ "currency", "amount", "request_id" ], "type": "object" }, "RecoverOriginalRefund": { "additionalProperties": false, "properties": { "confirm_unpaid_manual": { "const": true, "type": "boolean" }, "expected_updated_at": { "format": "date-time", "type": "string" } }, "required": [ "confirm_unpaid_manual" ], "type": "object" }, "RefundHistory": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/RefundHistoryItem" }, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "total": { "minimum": 0, "type": "integer" } }, "type": "object" }, "RefundHistoryItem": { "additionalProperties": false, "properties": { "amount_cents": { "minimum": 0, "type": "integer" }, "case_id": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "currency": { "type": "string" }, "id": { "type": "string" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "order_id": { "type": "string" }, "provider": { "enum": [ "paypal", "waffo", "paddle" ], "type": "string" }, "provider_refund_id": { "type": "string" }, "reason": { "type": "string" }, "settled_cents": { "minimum": 0, "type": "integer" }, "status": { "type": "string" } }, "type": "object" }, "RefundInboxItem": { "additionalProperties": false, "properties": { "amount_cents": { "minimum": 0, "type": "integer" }, "cancellation_scope": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "currency": { "type": "string" }, "customer_email": { "type": "string" }, "id": { "format": "uuid", "type": "string" }, "manual_refund_pending": { "type": "boolean" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "order_id": { "type": "string" }, "pending_review": { "type": "boolean" }, "purchase_id": { "type": "string" }, "reason": { "type": "string" }, "refund_totals": { "description": "Jumlah per mata uang yang dikodekan JSON untuk pembatalan bercakupan.", "type": "string" }, "reviewed_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scope": { "enum": [ "wallet", "service" ], "type": "string" }, "source": { "enum": [ "wallet_request", "support_case" ], "type": "string" }, "status": { "type": "string" }, "tenant_name": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "type": "object" }, "RefundInboxList": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/RefundInboxItem" }, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "summary": { "additionalProperties": false, "properties": { "pending_review": { "minimum": 0, "type": "integer" }, "service_pending_review": { "minimum": 0, "type": "integer" }, "wallet_pending_review": { "minimum": 0, "type": "integer" } }, "type": "object" }, "total": { "minimum": 0, "type": "integer" } }, "type": "object" }, "RefundInput": { "additionalProperties": false, "properties": { "amount": { "description": "Jumlah pengembalian positif dalam mata uang capture; tidak boleh melebihi dana capture tersisa atau kredit dompet tersedia yang belum dibelanjakan.", "pattern": "^[0-9]+(?:\\.[0-9]{1,2})?$", "type": "string" }, "reason": { "maxLength": 255, "minLength": 1, "type": "string" }, "request_id": { "maxLength": 80, "minLength": 1, "type": "string" } }, "required": [ "amount", "reason", "request_id" ], "type": "object" }, "RefundList": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/PayPalRefund" }, "type": "array" }, "total": { "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "RefundQuote": { "additionalProperties": false, "properties": { "amount_cents": { "type": "integer" }, "automatic_entitlement_cancellation": { "type": "boolean" }, "currency": { "type": "string" }, "purchase_id": { "format": "uuid", "type": "string" }, "quoted_at": { "format": "date-time", "type": "string" }, "requires_confirmation": { "type": "boolean" } }, "required": [], "type": "object" }, "RefundReview": { "additionalProperties": false, "properties": { "amount": { "type": "string" }, "amounts": { "items": { "additionalProperties": false, "properties": { "amount": { "type": "string" }, "purchase_id": { "format": "uuid", "type": "string" } }, "required": [ "purchase_id", "amount" ], "type": "object" }, "type": "array" }, "approve": { "type": "boolean" }, "decision": { "maxLength": 3000, "type": "string" }, "expected_updated_at": { "format": "date-time", "type": "string" }, "quote_hash": { "type": "string" }, "quoted_at": { "format": "date-time", "type": "string" } }, "required": [ "approve", "decision" ], "type": "object" }, "Register": { "additionalProperties": false, "properties": { "email": { "format": "email", "type": "string" }, "name": { "maxLength": 120, "minLength": 1, "type": "string" }, "overage_accepted": { "description": "Otorisasi eksplisit terpisah untuk kelebihan penggunaan berbayar yang ditampilkan.", "type": "boolean" }, "password": { "description": "12–128 byte UTF-8, bukan karakter", "type": "string", "writeOnly": true }, "password_confirmation": { "description": "Wajib dan harus sama persis dengan kata sandi", "type": "string", "writeOnly": true }, "policy_version": { "description": "Versi kebijakan tidak berubah yang saat ini diterbitkan. Wajib untuk tindakan yang dilindungi persetujuan setelah operator menerbitkan kebijakan, pada kedua lingkungan pembayaran.", "type": "string" }, "tenant_name": { "maxLength": 120, "minLength": 1, "type": "string" }, "terms_accepted": { "description": "Persetujuan eksplisit yang secara default tidak dicentang.", "type": "boolean" } }, "required": [ "email", "password", "password_confirmation", "name", "tenant_name" ], "type": "object" }, "Release": { "additionalProperties": false, "example": { "channel": "stable", "created_at": "2026-10-18T00:00:00Z", "download_url": "", "id": "33333333-3333-4333-8333-333333333333", "notes": "Initial release", "product_id": "11111111-1111-4111-8111-111111111111", "published_at": "2026-10-18T00:00:00Z", "sha256": "", "version": "1.0.0" }, "properties": { "channel": { "description": "Kanal rilis, stable atau preview; default stable.", "type": "string" }, "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "download_url": { "description": "URL unduhan HTTPS; sha256 wajib jika URL diberikan.", "type": "string" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "notes": { "description": "Catatan rilis.", "type": "string" }, "product_id": { "description": "UUID produk di ruang kerja saat ini.", "format": "uuid", "type": "string" }, "published_at": { "description": "Stempel waktu publikasi rilis, UTC; default waktu server.", "format": "date-time", "type": "string" }, "sha256": { "description": "SHA-256 file unduhan, 64 karakter heksadesimal huruf kecil, berbeda dari algoritma tanda tangan.", "type": "string" }, "version": { "description": "Revisi kebijakan, versi produk major.minor.patch, atau versi protokol offline 1, bergantung pada objek.", "type": "string" } }, "required": [ "id", "product_id", "version", "channel", "notes", "download_url", "sha256", "published_at", "created_at" ], "type": "object" }, "ReleaseInput": { "additionalProperties": false, "properties": { "channel": { "description": "Kanal rilis, stable atau preview; default stable.", "enum": [ "stable", "preview" ], "type": "string" }, "download_url": { "description": "URL unduhan HTTPS; sha256 wajib jika URL diberikan.", "format": "uri", "maxLength": 2000, "type": "string" }, "notes": { "description": "Catatan rilis.", "maxLength": 10000, "type": "string" }, "published_at": { "description": "Stempel waktu publikasi rilis, UTC; default waktu server.", "format": "date-time", "type": "string" }, "sha256": { "description": "SHA-256 file unduhan, 64 karakter heksadesimal huruf kecil, berbeda dari algoritma tanda tangan.", "pattern": "^[0-9a-f]{64}$", "type": "string" }, "version": { "description": "Revisi kebijakan, versi produk major.minor.patch, atau versi protokol offline 1, bergantung pada objek.", "pattern": "^(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})$", "type": "string" } }, "required": [ "version" ], "type": "object" }, "ReleaseList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/Release" }, "type": "array" }, "limit": { "description": "Ukuran halaman, default 25, rentang 1–100.", "type": "integer" }, "offset": { "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "type": "integer" }, "total": { "description": "Total catatan yang cocok, bukan panjang halaman saat ini.", "type": "integer" } }, "required": [ "items", "total", "limit", "offset" ], "type": "object" }, "Renew": { "additionalProperties": false, "properties": { "days": { "description": "Hari tambahan, 1–36500; perpanjangan lisensi dan pemeliharaan memengaruhi ketentuan berbeda.", "maximum": 36500, "minimum": 1, "type": "integer" } }, "required": [ "days" ], "type": "object" }, "RenewalPlans": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/Price" }, "type": "array" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "sandbox", "live" ], "type": "string" } }, "required": [ "items", "mode" ], "type": "object" }, "Renewed": { "additionalProperties": false, "example": { "duration_days": 60, "expires_at": null, "id": "33333333-3333-4333-8333-333333333333" }, "properties": { "duration_days": { "description": "Perpanjangan sebelum aktivasi pertama meningkatkan nilai ini. Setelah aktivasi, nilai mempertahankan durasi asli; gunakan expires_at untuk tenggat sebenarnya.", "maximum": 36500, "minimum": 1, "type": [ "integer", "null" ] }, "expires_at": { "anyOf": [ { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "format": "date-time", "type": "string" }, { "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial.", "type": "null" } ], "description": "Kedaluwarsa lisensi; null untuk lisensi timed/trial yang belum diaktifkan atau lisensi perpetual. Pada objek kunci, kedaluwarsa kredensial." }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } }, "required": [ "id", "expires_at", "duration_days" ], "type": "object" }, "ReservationResult": { "additionalProperties": false, "properties": { "activation_id": { "description": "UUID pengikatan perangkat atau sesi runtime. Simpan untuk permintaan lisensi berikutnya; bukan kunci lisensi.", "format": "uuid", "type": "string" }, "heartbeat_seconds": { "anyOf": [ { "const": 0 }, { "maximum": 86400, "minimum": 600, "type": "integer" } ], "description": "Interval heartbeat saat ini dalam detik; pengukuran tidak memperbarui tanda tangan atau pengatur waktu.", "type": "integer" }, "reservation": { "$ref": "#/components/schemas/FeatureReservation" } }, "required": [ "activation_id", "reservation" ], "type": "object" }, "Revenue": { "additionalProperties": false, "properties": { "invoices": { "items": { "additionalProperties": false, "properties": { "currency": { "pattern": "^[A-Z]{3}$", "type": "string" }, "email": { "type": "string" }, "id": { "format": "uuid", "type": "string" }, "month": { "type": "string" }, "paid_at": { "format": "date-time", "type": "string" }, "plan": { "type": "string" }, "plan_name": { "type": "string" }, "refunded_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "tenant_name": { "type": "string" }, "total_cents": { "type": "integer" } }, "required": [], "type": "object" }, "type": "array" }, "limit": { "type": "integer" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "month": { "type": "string" }, "offset": { "type": "integer" }, "paddle_totals": { "description": "Pembayaran bruto dan pengembalian kumulatif untuk pembelian layanan dan isi ulang dompet, dikelompokkan menurut bulan pembayaran asli dan mata uang; bukan penyelesaian bank.", "items": { "additionalProperties": false, "properties": { "currency": { "description": "Nama tampilan layanan pembayaran.", "type": "string" }, "paid_cents": { "description": "Harga layanan penuh yang dibekukan dalam unit mata uang terkecil; tanpa isi ulang dompet atau pembayaran campuran.", "type": "integer" }, "refunded_cents": { "description": "Harga layanan penuh yang dibekukan dalam unit mata uang terkecil; tanpa isi ulang dompet atau pembayaran campuran.", "type": "integer" } }, "required": [ "currency", "paid_cents", "refunded_cents" ], "type": "object" }, "type": "array" }, "paid_users": { "type": "integer" }, "purchase_total": { "type": "integer" }, "purchases": { "items": { "additionalProperties": false, "properties": { "api_calls": { "type": "integer" }, "api_overage_cents": { "type": "integer" }, "base_cents": { "type": "integer" }, "currency": { "pattern": "^[A-Z]{3}$", "type": "string" }, "email": { "type": "string" }, "ends_at": { "format": "date-time", "type": "string" }, "id": { "format": "uuid", "type": "string" }, "overage_cents": { "type": "integer" }, "plan": { "pattern": "^[a-z][a-z0-9_-]{0,63}$", "type": "string" }, "plan_name": { "type": "string" }, "source": { "enum": [ "purchase", "gift" ], "type": "string" }, "starts_at": { "format": "date-time", "type": "string" }, "status": { "enum": [ "pending", "active", "cancelled" ], "type": "string" }, "tenant_name": { "type": "string" }, "term_months": { "default": 1, "enum": [ 1, 3, 6, 12 ], "type": "integer" } }, "required": [], "type": "object" }, "type": "array" }, "recharged_users": { "type": "integer" }, "registered_users": { "type": "integer" }, "sales": { "items": { "additionalProperties": false, "properties": { "currency": { "pattern": "^[A-Z]{3}$", "type": "string" }, "plan": { "type": "string" }, "plan_name": { "type": "string" }, "quantity": { "type": "integer" }, "total_cents": { "type": "integer" } }, "required": [], "type": "object" }, "type": "array" }, "sold_subscriptions": { "type": "integer" }, "timezone": { "type": "string" }, "topup_total": { "type": "integer" }, "topups": { "items": { "additionalProperties": false, "properties": { "amount_cents": { "type": "integer" }, "credited_at": { "format": "date-time", "type": "string" }, "currency": { "pattern": "^[A-Z]{3}$", "type": "string" }, "email": { "type": "string" }, "id": { "format": "uuid", "type": "string" }, "provider": { "description": "Penyedia asli isi ulang dompet; pengembalian dana tetap terikat pada penyedia ini.", "enum": [ "paypal", "paddle", "waffo" ], "type": "string" }, "refunded_cents": { "type": "integer" }, "status": { "type": "string" }, "tenant_name": { "type": "string" } }, "required": [], "type": "object" }, "type": "array" }, "total": { "type": "integer" }, "totals": { "items": { "additionalProperties": false, "properties": { "consumption_cents": { "type": "integer" }, "consumption_refund_cents": { "type": "integer" }, "currency": { "pattern": "^[A-Z]{3}$", "type": "string" }, "paypal_refund_cents": { "type": "integer" }, "recharge_cents": { "type": "integer" }, "wallet_refund_cents": { "description": "Pengembalian/pembalikan dompet yang dilaksanakan melalui PayPal, Paddle, dan Waffo; tidak termasuk penahanan sementara pengembalian dana.", "type": "integer" } }, "required": [], "type": "object" }, "type": "array" }, "upgrade_total": { "description": "Jumlah peningkatan yang diterapkan dalam lingkungan dan periode pelaporan yang dipilih, termasuk peningkatan gratis. Dihitung terpisah dari penjualan paket awal.", "type": "integer" }, "upgrades": { "items": { "additionalProperties": false, "properties": { "amount_cents": { "description": "Jumlah proporsional yang benar-benar dibayar; bukan harga bulanan penuh yang baru.", "type": "integer" }, "applied_at": { "format": "date-time", "type": "string" }, "currency": { "type": "string" }, "email": { "type": "string" }, "ends_at": { "description": "Kedaluwarsa paket asli, tidak berubah oleh peningkatan.", "format": "date-time", "type": "string" }, "id": { "format": "uuid", "type": "string" }, "plan_name": { "description": "Nama paket target.", "type": "string" }, "previous_plan_name": { "description": "Paket efektif sebelum peningkatan ini.", "type": "string" }, "tenant_name": { "type": "string" } }, "required": [ "id", "email", "tenant_name", "plan_name", "previous_plan_name", "currency", "amount_cents", "applied_at", "ends_at" ], "type": "object" }, "type": "array" }, "waffo_totals": { "description": "Pembayaran bruto dan pengembalian kumulatif untuk pembelian layanan dan isi ulang dompet, dikelompokkan menurut bulan pembayaran asli dan mata uang; bukan penyelesaian bank.", "items": { "additionalProperties": false, "properties": { "currency": { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" }, "paid_cents": { "description": "Harga layanan penuh yang dibekukan dalam unit mata uang terkecil; tanpa isi ulang dompet atau pembayaran campuran.", "type": "integer" }, "refunded_cents": { "description": "Harga layanan penuh yang dibekukan dalam unit mata uang terkecil; tanpa isi ulang dompet atau pembayaran campuran.", "type": "integer" } }, "required": [ "currency", "paid_cents", "refunded_cents" ], "type": "object" }, "type": "array" } }, "required": [], "type": "object" }, "RuntimeAPIPeriod": { "additionalProperties": false, "properties": { "api_calls": { "description": "Panggilan API runtime terukur yang berhasil dalam cakupan; permintaan manajemen dikecualikan.", "type": "integer" }, "api_hard_limit": { "description": "Apakah panggilan runtime berhenti pada batas jatah API.", "type": "boolean" }, "api_overage_cents": { "description": "Biaya kelebihan API dalam seperseratus pada siklus ini.", "type": "integer" }, "api_unit_micros": { "description": "Harga per kelebihan panggilan runtime dalam sepersejuta.", "minimum": 0, "type": "integer" }, "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "currency": { "description": "Kode mata uang huruf besar tiga huruf, seperti USD.", "pattern": "^[A-Z]{3}$", "type": "string" }, "included_api_calls": { "description": "null = tak terbatas; 0 = tidak ada panggilan berhasil yang disertakan", "maximum": 1000000000000, "minimum": 0, "type": [ "integer", "null" ] }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "sandbox", "live" ], "type": "string" }, "month": { "description": "Bulan UTC YYYY-MM; nilai kueri yang dihilangkan menggunakan bulan saat ini. Job penagihan memerlukan bulan yang telah ditutup.", "type": "string" }, "plan": { "description": "Pengenal paket penagihan stabil dari katalog yang diterbitkan.", "pattern": "^[a-z][a-z0-9_-]{0,63}$", "type": "string" }, "price_version": { "description": "Revisi harga yang dibekukan; input usang dapat menyebabkan PLAN_VERSION_CONFLICT.", "type": "string" } }, "required": [], "type": "object" }, "RuntimeInput": { "additionalProperties": false, "properties": { "activation_id": { "description": "data.activation_id dari aktivasi terakhir yang berhasil. Wajib untuk validasi, heartbeat, consume, dan deaktivasi; hilangkan hanya pada activate pertama.", "format": "uuid", "type": "string" }, "app_version": { "description": "Versi aplikasi saat ini, major.minor.patch, misalnya 1.0.0. Wajib untuk aturan pemeliharaan atau rentang versi. Jangan melaporkan aplikasi yang lebih baru sebagai versi lama.", "pattern": "^$|^(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})$", "type": "string" }, "device_id": { "description": "SHA-256 heksadesimal huruf kecil sepanjang 64 karakter yang dihitung SDK dari identitas produk, sistem, dan perangkat keras. Jangan ganti dengan nilai tetap.", "pattern": "^[0-9a-f]{64}$", "type": "string" }, "device_name": { "description": "Nama tampilan di dasbor, hingga 120 karakter. Tidak menentukan identitas perangkat.", "maxLength": 120, "type": "string" }, "device_profile": { "$ref": "#/components/schemas/DeviceProfile", "description": "Profil mesin yang dibuat SDK. Berikan sesuai kebutuhan kebijakan untuk identitas perangkat keras, penolakan VM, atau migrasi perangkat keras." }, "environment": { "description": "Lingkungan perdagangan, dipatok pada koneksi dan grant bertanda tangan.", "enum": [ "live", "sandbox" ], "type": "string" }, "feature": { "description": "Pengenal fitur yang dikonsumsi.", "maxLength": 64, "type": "string" }, "identity_token": { "description": "JWT identitas Launch Ed25519 sekali pakai dan bertipe; tidak ada klaim entitlement yang dipercaya sebagai hak pembelian.", "maxLength": 12288, "type": "string", "writeOnly": true }, "launch_connection_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "license_key": { "description": "Kunci pelanggan lengkap: lv_lic_ adalah kunci lisensi biasa; lv_tmp_ untuk penebusan transfer awal. Setelah berhasil, SDK menggunakan kredensial lv_dev_ yang terikat pada mesin. Bukan API Key manajemen vendor.", "pattern": "^(?:lv_(?:lic|tmp|dev)_[A-Za-z0-9_-]{43})?$", "type": "string", "writeOnly": true }, "product_id": { "description": "UUID produk; harus cocok dengan produk lisensi.", "format": "uuid", "type": "string" }, "quantity": { "description": "Unit yang diminta untuk operasi ini, bilangan bulat 1–1000000000.", "maximum": 1000000000, "minimum": 1, "type": "integer" }, "request_logout_ticket": { "description": "Negosiasi kemampuan SDK. Minta tiket logout khusus unlink jika tidak ada tiket yang disimpan untuk pengikatan saat ini. Hilangkan jika tiket logout valid sudah disimpan; heartbeat kondisi stabil menghindari pencarian tiket tambahan.", "type": "boolean" }, "reservation_id": { "description": "ID reservasi; kirim nilai ini untuk commit atau cancel.", "format": "uuid", "type": "string" }, "reservation_seconds": { "default": 900, "description": "Masa berlaku reservasi opsional, 30–3600 detik; default 900. Berakhir lebih awal saat reset periode.", "maximum": 3600, "minimum": 30, "type": "integer" }, "session_id": { "description": "Wajib untuk lisensi floating: buat UUID per instance yang berjalan dan gunakan kembali untuk permintaan instance tersebut. Opsional untuk lisensi terikat perangkat.", "format": "uuid", "type": "string" } }, "required": [ "product_id", "license_key", "device_id" ], "type": "object" }, "RuntimePolicy": { "additionalProperties": false, "properties": { "heartbeat_seconds": { "anyOf": [ { "const": 0 }, { "maximum": 86400, "minimum": 600, "type": "integer" } ], "description": "Interval heartbeat saat online, dalam detik. 0 menonaktifkan heartbeat berkala. Jatah offline dikonfigurasi terpisah.", "type": "integer" }, "offline_mode": { "description": "limited: offline terbatas waktu; none: tanpa penggunaan offline; permanent: tanpa batas waktu offline tambahan, tetapi kedaluwarsa lisensi tetap berlaku.", "enum": [ "limited", "none", "permanent" ], "type": "string" }, "offline_seconds": { "description": "Detik offline yang diizinkan: 1–31536000 untuk limited, 0 untuk none/permanent. Ini bukan interval heartbeat. Saat heartbeat aktif, kebijakan offline terbatas yang baru harus memenuhi offline_seconds \u003e= 3 × heartbeat_seconds; masa sewa kursi mengambang juga harus mencakup setidaknya tiga interval heartbeat.", "maximum": 31536000, "minimum": 0, "type": "integer" } }, "required": [ "heartbeat_seconds", "offline_mode", "offline_seconds" ], "type": "object" }, "RuntimeResult": { "additionalProperties": false, "properties": { "activation_id": { "description": "UUID pengikatan perangkat atau sesi runtime. Simpan untuk permintaan lisensi berikutnya; bukan kunci lisensi.", "format": "uuid", "type": "string" }, "deactivated": { "description": "true pada deaktivasi berhasil. Melepas pengikatan atau sesi; tidak menghapus lisensi atau mengatur ulang jangka waktunya.", "type": "boolean" }, "device_key": { "description": "Kredensial perangkat terbatas yang dipatok ke perangkat dan versi pengikatan. Kredensial mode akun juga memerlukan sesi otorisasi dan hak yang aktif; tidak dapat mengaktifkan kembali pengikatan yang telah dilepas.", "pattern": "^lv_dev_[A-Za-z0-9_-]{43}$", "type": "string" }, "heartbeat_seconds": { "anyOf": [ { "const": 0, "description": "Interval heartbeat dalam detik: 0 menonaktifkannya; selain itu 600–86400. Jika dihilangkan menggunakan default server; independen dari jatah offline." }, { "description": "Interval heartbeat dalam detik: 0 menonaktifkannya; selain itu 600–86400. Jika dihilangkan menggunakan default server; independen dari jatah offline.", "maximum": 86400, "minimum": 600, "type": "integer" } ], "description": "Detik heartbeat yang disarankan. Bidang tingkat teratas dapat dihilangkan untuk 0; runtime_policy.heartbeat_seconds dalam tanda tangan adalah nilai kebijakan otoritatif.", "type": "integer" }, "lease": { "$ref": "#/components/schemas/Lease", "description": "Cache lisensi bertanda tangan server. Terima hanya setelah memverifikasi dengan kunci publik tepercaya yang dipatok dan memeriksa produk/perangkat. Tidak dikembalikan oleh deaktivasi atau consume." }, "logout_ticket": { "$ref": "#/components/schemas/LogoutTicket", "description": "Kemampuan khusus unlink untuk inkarnasi pengikatan yang tepat ini; jauhkan dari log permintaan runtime." } }, "required": [ "activation_id" ], "type": "object" }, "SDKConfig": { "additionalProperties": false, "example": { "allow_http": false, "app_version": "", "base_url": "https://www.licentivo.com", "cache_path": "", "device_name": "My application", "license_key": "", "product_id": "11111111-1111-4111-8111-111111111111", "trusted_keys": { "66666666-6666-4666-8666-666666666666": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" } }, "properties": { "allow_http": { "description": "Apakah HTTP diizinkan, hanya untuk pengembangan lokal.", "type": "boolean" }, "app_version": { "description": "Versi perangkat lunak saat ini major.minor.patch.", "type": "string" }, "base_url": { "description": "Origin server lisensi, biasanya HTTPS, tanpa /api/v1.", "type": "string" }, "cache_path": { "description": "Path cache lokal; kosong memungkinkan SDK memilih direktori pengguna privat.", "type": "string" }, "device_name": { "description": "Label perangkat yang dapat dibaca manusia, bukan identitas keamanan.", "type": "string" }, "license_key": { "description": "Kunci lisensi pelanggan lengkap yang diberikan saat aktivasi. Kode inisialisasi produk dan unduhan contoh tidak berisi rahasia ini. Permintaan offline menggunakan kredensial yang diberikan SDK.", "type": "string" }, "product_id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "trusted_keys": { "additionalProperties": { "type": "string" }, "description": "Pemetaan dari UUID kunci publik ke kunci publik Base64URL untuk verifikasi yang dipatok.", "type": "object" } }, "required": [ "base_url", "product_id", "license_key", "app_version", "device_name", "trusted_keys", "cache_path", "allow_http" ], "type": "object" }, "SDKExampleInfo": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "can_configure": { "type": "boolean" }, "duration_days": { "const": 3, "type": "integer" }, "starts_at_first_activation": { "type": "boolean" } }, "required": [], "type": "object" }, "SDKExampleSetting": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "duration_days": { "const": 3, "type": "integer" }, "policy_id": { "description": "UUID kebijakan khusus; kosong sebelum penyiapan awal.", "type": "string" }, "product_id": { "description": "UUID produk khusus; kosong sebelum penyiapan awal.", "type": "string" } }, "required": [ "available", "duration_days", "product_id", "policy_id" ], "type": "object" }, "SDKExampleSetup": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" } }, "required": [], "type": "object" }, "SDKExampleTrial": { "additionalProperties": false, "properties": { "duration_days": { "const": 3, "type": "integer" }, "expires_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "first_activated_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "license_key": { "type": "string" }, "starts_at_first_activation": { "type": "boolean" }, "status": { "type": "string" } }, "required": [], "type": "object" }, "SDKInitializer": { "additionalProperties": false, "example": { "language": "go", "product_id": "11111111-1111-4111-8111-111111111111", "source": "const productID = \"11111111-1111-4111-8111-111111111111\"\nvar trustedKeys = map[string]string{\"66666666-6666-4666-8666-666666666666\": \"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\"}\n", "trusted_keys": { "66666666-6666-4666-8666-666666666666": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" } }, "properties": { "language": { "description": "Pengenal bahasa SDK untuk bundel unduhan.", "type": "string" }, "product_id": { "description": "UUID produk di ruang kerja saat ini.", "format": "uuid", "type": "string" }, "source": { "description": "Konstanta produk publik untuk ditempel ke kode; tanpa rahasia aktivasi pelanggan.", "type": "string" }, "trusted_keys": { "additionalProperties": { "type": "string" }, "description": "Pemetaan dari UUID kunci publik ke kunci publik Base64URL untuk verifikasi yang dipatok.", "type": "object" } }, "required": [ "product_id", "trusted_keys", "language", "source" ], "type": "object" }, "ScheduledPlan": { "additionalProperties": false, "properties": { "currency": { "description": "Kode mata uang huruf besar tiga huruf, seperti USD.", "type": "string" }, "effective_month": { "description": "Bulan UTC YYYY-MM saat jadwal berlaku.", "type": "string" }, "plan": { "description": "Pengenal paket penagihan stabil dari katalog yang diterbitkan.", "type": "string" }, "sandbox": { "description": "Lingkungan sandbox.", "type": "boolean" } }, "required": [], "type": "object" }, "ScopedRefundPreview": { "additionalProperties": false, "properties": { "affected_purchases": { "items": { "$ref": "#/components/schemas/ScopedRefundPurchase" }, "type": "array" }, "auto_renewal_disabled": { "type": "boolean" }, "auto_renewal_enabled": { "type": "boolean" }, "cancellation_at": { "const": "approval", "type": "string" }, "pending_purchase_ids": { "items": { "format": "uuid", "type": "string" }, "type": "array" }, "pending_upgrade_ids": { "items": { "format": "uuid", "type": "string" }, "type": "array" }, "quote_hash": { "type": "string" }, "quoted_at": { "format": "date-time", "type": "string" }, "remaining_purchases": { "items": { "$ref": "#/components/schemas/ScopedRefundPurchase" }, "type": "array" }, "request": { "$ref": "#/components/schemas/CustomerRefundInput" }, "scope": { "enum": [ "purchase", "service" ], "type": "string" }, "totals": { "items": { "$ref": "#/components/schemas/ScopedRefundTotal" }, "type": "array" } }, "required": [], "type": "object" }, "ScopedRefundPurchase": { "additionalProperties": false, "properties": { "amount_cents": { "type": "integer" }, "approved_cents": { "type": "integer" }, "currency": { "type": "string" }, "ends_at": { "format": "date-time", "type": "string" }, "maximum_cents": { "type": "integer" }, "plan_name": { "type": "string" }, "purchase_id": { "format": "uuid", "type": "string" }, "requires_review": { "type": "boolean" }, "source": { "type": "string" }, "starts_at": { "format": "date-time", "type": "string" } }, "required": [], "type": "object" }, "ScopedRefundTotal": { "additionalProperties": false, "properties": { "amount_cents": { "type": "integer" }, "approved_cents": { "type": "integer" }, "currency": { "type": "string" }, "held_cents": { "type": "integer" }, "manual_cents": { "type": "integer" } }, "required": [], "type": "object" }, "ServiceCompensation": { "additionalProperties": false, "properties": { "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "incident_id": { "description": "UUID insiden layanan terkait.", "format": "uuid", "type": "string" }, "intervals": { "description": "Interval waktu yang dikompensasi dikembalikan sebagai string JSON.", "type": "string" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "type": "string" }, "purchase_id": { "description": "UUID pembelian paket terkait.", "format": "uuid", "type": "string" }, "seconds": { "description": "Detik yang ditambahkan sebagai kompensasi layanan.", "type": "integer" } }, "required": [ "id", "incident_id", "mode", "seconds", "purchase_id", "created_at" ], "type": "object" }, "ServiceCompensationList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/ServiceCompensation" }, "type": "array" } }, "required": [ "items" ], "type": "object" }, "ServiceIncident": { "additionalProperties": false, "properties": { "affected_tenants": { "description": "Array ID ruang kerja yang dikodekan JSON; [] berarti global.", "type": "string" }, "body": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "emergency": { "type": "boolean" }, "ends_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "id": { "format": "uuid", "type": "string" }, "kind": { "type": "string" }, "starts_at": { "format": "date-time", "type": "string" }, "status": { "type": "string" }, "title": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" }, "version": { "type": "string" } }, "required": [], "type": "object" }, "ServiceIncidentInput": { "additionalProperties": false, "properties": { "affected_tenants": { "items": { "format": "uuid", "type": "string" }, "type": "array" }, "body": { "type": "string" }, "emergency": { "type": "boolean" }, "ends_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "expected_version": { "type": "string" }, "id": { "type": "string" }, "kind": { "enum": [ "maintenance", "incident" ], "type": "string" }, "starts_at": { "format": "date-time", "type": "string" }, "title": { "type": "string" } }, "required": [ "kind", "title", "body", "starts_at" ], "type": "object" }, "ServiceIncidentList": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/ServiceIncident" }, "type": "array" }, "now": { "format": "date-time", "type": "string" }, "total": { "type": "integer" } }, "required": [], "type": "object" }, "SignedCapabilities": { "additionalProperties": false, "properties": { "app_version": { "description": "app version untuk operasi otorisasi Launch ini.", "pattern": "^(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})$", "type": "string" }, "binding_version": { "description": "Generasi pengikatan perangkat bertanda tangan yang terkait dengan sesi otorisasi.", "minimum": 1, "type": "integer" }, "environment": { "description": "Lingkungan perdagangan, dipatok pada koneksi dan grant bertanda tangan.", "enum": [ "live", "sandbox" ], "type": "string" }, "launch_connection_id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "license_model": { "description": "license model untuk operasi otorisasi Launch ini.", "enum": [ "node_locked", "floating" ], "type": "string" }, "maintenance_until": { "description": "maintenance until untuk operasi otorisasi Launch ini.", "type": "integer" }, "session_expires_at": { "description": "session expires at untuk operasi otorisasi Launch ini.", "maximum": 253402300799, "type": "integer" }, "session_id": { "description": "session id untuk operasi otorisasi Launch ini.", "format": "uuid", "type": "string" }, "version_released_at": { "description": "version released at untuk operasi otorisasi Launch ini.", "type": "integer" } }, "required": [ "license_model" ], "type": "object" }, "SigningKey": { "additionalProperties": false, "properties": { "active": { "description": "Flag kunci penandatanganan saat ini; dalam pratinjau kebijakan, jumlah perangkat/sesi aktif.", "type": "boolean" }, "algorithm": { "const": "Ed25519", "description": "Algoritma penandatanganan, saat ini Ed25519.", "type": "string" }, "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "key_id": { "description": "UUID kunci penandatanganan produk yang digunakan untuk memilih kunci verifikasi.", "format": "uuid", "type": "string" }, "public_key": { "description": "Kunci publik Ed25519 yang dikodekan Base64URL; tanpa materi privat.", "type": "string" }, "retired_at": { "anyOf": [ { "description": "Stempel waktu penghentian kunci; null untuk kunci saat ini. Kunci publik yang dihentikan tetap tersedia untuk verifikasi.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu penghentian kunci; null untuk kunci saat ini. Kunci publik yang dihentikan tetap tersedia untuk verifikasi.", "type": "null" } ], "description": "Stempel waktu penghentian kunci; null untuk kunci saat ini. Kunci publik yang dihentikan tetap tersedia untuk verifikasi." } }, "required": [ "key_id", "public_key", "active" ], "type": "object" }, "StateResult": { "additionalProperties": false, "example": { "id": "33333333-3333-4333-8333-333333333333", "status": "pending" }, "properties": { "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "status": { "description": "Status resource saat ini; lihat enum dan catatan operasi.", "type": "string" } }, "required": [ "id", "status" ], "type": "object" }, "Subscription": { "additionalProperties": false, "properties": { "current": { "$ref": "#/components/schemas/Period", "description": "Snapshot penagihan default untuk bulan UTC saat ini." }, "next": { "anyOf": [ { "$ref": "#/components/schemas/PendingPlan", "description": "Paket default terjadwal untuk bulan berikutnya, atau null." }, { "description": "Paket default terjadwal untuk bulan berikutnya, atau null.", "type": "null" } ], "description": "Paket default terjadwal untuk bulan berikutnya, atau null." }, "sandbox": { "description": "Pratinjau langganan ini mengembalikan true. Tentukan lingkungan pembayaran sebenarnya dari pengaturan penagihan/pembayaran, bukan flag pratinjau ini.", "type": "boolean" } }, "required": [], "type": "object" }, "Summary": { "additionalProperties": false, "properties": { "active_licenses": { "description": "Jumlah lisensi aktif yang belum kedaluwarsa, termasuk yang menunggu aktivasi pertama.", "type": "integer" }, "licenses": { "description": "Jumlah lisensi yang tidak diarsipkan.", "type": "integer" }, "policies": { "description": "Jumlah kebijakan yang tidak diarsipkan.", "type": "integer" }, "products": { "description": "Jumlah produk dalam ringkasan; kelompok penggunaan perangkat per produk dalam respons penggunaan.", "type": "integer" } }, "required": [ "products", "policies", "licenses", "active_licenses" ], "type": "object" }, "SupportCase": { "additionalProperties": false, "properties": { "amount_cents": { "type": "integer" }, "approved_cents": { "type": "integer" }, "cancellation_preview": { "description": "Pratinjau pembatalan yang dikodekan JSON.", "type": "string" }, "cancellation_scope": { "type": "string" }, "change_id": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "currency": { "type": "string" }, "decision": { "type": "string" }, "first_response_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "held_cents": { "type": "integer" }, "id": { "format": "uuid", "type": "string" }, "incident_id": { "type": "string" }, "kind": { "type": "string" }, "manual_cents": { "type": "integer" }, "manual_refund_pending": { "type": "boolean" }, "mode": { "type": "string" }, "order_id": { "type": "string" }, "purchase_id": { "type": "string" }, "reason": { "type": "string" }, "refund_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "refund_totals": { "description": "Total per mata uang yang dikodekan JSON; jangan pernah menjumlahkan mata uang berbeda.", "type": "string" }, "request_id": { "type": "string" }, "response_due_at": { "format": "date-time", "type": "string" }, "review_due_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "reviewed_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scope_ids": { "type": "string" }, "status": { "type": "string" }, "subject": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [], "type": "object" }, "SupportCaseDetail": { "additionalProperties": false, "properties": { "case": { "$ref": "#/components/schemas/SupportCase" }, "messages": { "items": { "additionalProperties": false, "properties": { "body": { "type": "string" }, "case_id": { "format": "uuid", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "id": { "format": "uuid", "type": "string" }, "staff": { "type": "boolean" }, "user_id": { "format": "uuid", "type": "string" } }, "required": [], "type": "object" }, "type": "array" }, "original_refund_receipts": { "items": { "additionalProperties": false, "properties": { "amount_cents": { "minimum": 0, "type": "integer" }, "currency": { "type": "string" }, "intent_id": { "format": "uuid", "type": "string" }, "refund_id": { "type": "string" } }, "type": "object" }, "type": "array" }, "original_refunds": { "items": { "$ref": "#/components/schemas/ProviderRefund" }, "type": "array" }, "refund_payments": { "items": { "additionalProperties": false, "properties": { "amount_cents": { "minimum": 0, "type": "integer" }, "currency": { "type": "string" }, "id": { "format": "uuid", "type": "string" }, "provider": { "type": "string" }, "provider_order_id": { "type": "string" }, "refunded_cents": { "minimum": 0, "type": "integer" }, "status": { "type": "string" } }, "type": "object" }, "type": "array" }, "refund_provider": { "type": "string" }, "refund_unverified": { "type": "boolean" }, "refunds": { "items": { "$ref": "#/components/schemas/PayPalRefund" }, "type": "array" } }, "required": [], "type": "object" }, "SupportCaseInput": { "additionalProperties": false, "properties": { "body": { "maxLength": 10000, "type": "string" }, "kind": { "enum": [ "support", "privacy", "appeal" ], "type": "string" }, "request_id": { "maxLength": 80, "type": "string" }, "subject": { "maxLength": 200, "type": "string" } }, "required": [ "subject", "body", "request_id" ], "type": "object" }, "SupportCaseList": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/SupportCase" }, "type": "array" }, "now": { "format": "date-time", "type": "string" }, "total": { "type": "integer" } }, "required": [], "type": "object" }, "SupportContact": { "additionalProperties": false, "properties": { "email": { "description": "Email dukungan publik dan Reply-To untuk email penagihan. Kosong menyembunyikan kontak. Tidak mengubah alamat SMTP From yang ada atau membuat kotak masuk.", "maxLength": 254, "type": "string" } }, "required": [ "email" ], "type": "object" }, "SupportReadInput": { "additionalProperties": false, "properties": { "last_message_id": { "format": "uuid", "type": "string" } }, "required": [ "last_message_id" ], "type": "object" }, "SupportReply": { "additionalProperties": false, "properties": { "body": { "maxLength": 10000, "type": "string" }, "expected_updated_at": { "format": "date-time", "type": "string" }, "status": { "enum": [ "", "reviewing", "awaiting_info", "resolved" ], "type": "string" } }, "required": [ "body" ], "type": "object" }, "SupportUnread": { "additionalProperties": false, "properties": { "items": { "items": { "additionalProperties": false, "properties": { "case_id": { "format": "uuid", "type": "string" }, "unread_messages": { "type": "integer" } }, "required": [], "type": "object" }, "type": "array" }, "unread_cases": { "type": "integer" }, "unread_messages": { "type": "integer" }, "unread_notices": { "type": "integer" } }, "required": [], "type": "object" }, "SystemSettings": { "additionalProperties": false, "properties": { "database": { "$ref": "#/components/schemas/DatabaseStatus" }, "environment": { "type": "string" }, "mail": { "$ref": "#/components/schemas/MailSettings" }, "public_url": { "format": "uri", "type": "string" } }, "required": [ "mail", "database" ], "type": "object" }, "TLSCertificateInfo": { "additionalProperties": false, "properties": { "algorithm": { "type": "string" }, "chain_length": { "maximum": 10, "minimum": 1, "type": "integer" }, "domains": { "items": { "type": "string" }, "type": "array" }, "fingerprint_sha256": { "pattern": "^[0-9a-f]{64}$", "type": "string" }, "issuer": { "type": "string" }, "not_after": { "format": "date-time", "type": "string" }, "not_before": { "format": "date-time", "type": "string" }, "self_signed": { "type": "boolean" }, "serial_number": { "type": "string" }, "subject": { "type": "string" } }, "required": [ "domains", "subject", "issuer", "not_before", "not_after", "fingerprint_sha256", "serial_number", "algorithm", "chain_length", "self_signed" ], "type": "object" }, "TLSCertificateInput": { "additionalProperties": false, "properties": { "certificate_pem": { "description": "Sertifikat leaf PEM diikuti sertifikat perantaranya secara berurutan. Harus cocok dengan public_url. Hanya pengembangan lokal yang mengizinkan sertifikat self-signed.", "maxLength": 32768, "type": "string", "writeOnly": true }, "expected_version": { "description": "Gunakan version dari GET /system/tls. Wajib untuk pembaruan; penggantian bersamaan mengembalikan 409.", "type": "string" }, "private_key_pem": { "description": "Kunci PEM tanpa enkripsi yang cocok (PKCS#8, RSA atau EC). Tidak pernah dikembalikan oleh respons apa pun.", "maxLength": 16384, "type": "string", "writeOnly": true } }, "required": [ "certificate_pem", "private_key_pem" ], "type": "object" }, "TLSCertificateResult": { "additionalProperties": false, "properties": { "certificate": { "$ref": "#/components/schemas/TLSCertificateInfo" }, "updated_at": { "format": "date-time", "type": "string" }, "version": { "type": "string" } }, "required": [ "certificate", "version", "updated_at" ], "type": "object" }, "TLSCertificateUpdateInput": { "additionalProperties": false, "properties": { "certificate_pem": { "description": "Sertifikat leaf PEM diikuti sertifikat perantaranya secara berurutan. Harus cocok dengan public_url. Hanya pengembangan lokal yang mengizinkan sertifikat self-signed.", "maxLength": 32768, "type": "string", "writeOnly": true }, "expected_version": { "description": "Gunakan version dari GET /system/tls. Wajib untuk pembaruan; penggantian bersamaan mengembalikan 409.", "type": "string" }, "private_key_pem": { "description": "Kunci PEM tanpa enkripsi yang cocok (PKCS#8, RSA atau EC). Tidak pernah dikembalikan oleh respons apa pun.", "maxLength": 16384, "type": "string", "writeOnly": true } }, "required": [ "certificate_pem", "private_key_pem", "expected_version" ], "type": "object" }, "TLSStatus": { "additionalProperties": false, "properties": { "address": { "type": "string" }, "certificate": { "anyOf": [ { "$ref": "#/components/schemas/TLSCertificateInfo" }, { "type": "null" } ] }, "enabled": { "type": "boolean" }, "http_redirect_address": { "type": "string" }, "public_url": { "type": "string" }, "updated_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "version": { "type": "string" } }, "required": [ "enabled", "public_url", "address", "http_redirect_address", "certificate", "version", "updated_at" ], "type": "object" }, "TestMail": { "additionalProperties": false, "properties": { "to": { "format": "email", "type": "string" } }, "required": [ "to" ], "type": "object" }, "Token": { "additionalProperties": false, "properties": { "token": { "maxLength": 100, "minLength": 32, "type": "string", "writeOnly": true } }, "required": [ "token" ], "type": "object" }, "TokenPassword": { "additionalProperties": false, "properties": { "password": { "description": "12–128 byte UTF-8, bukan karakter", "type": "string", "writeOnly": true }, "password_confirmation": { "description": "Wajib dan harus sama persis dengan kata sandi", "type": "string", "writeOnly": true }, "token": { "maxLength": 100, "minLength": 32, "type": "string", "writeOnly": true } }, "required": [ "token", "password", "password_confirmation" ], "type": "object" }, "TransferCode": { "additionalProperties": false, "properties": { "activation_code": { "pattern": "^lv_tmp_[A-Za-z0-9_-]{43}$", "type": "string" }, "activation_id": { "format": "uuid", "type": "string" }, "expires_at": { "format": "date-time", "type": "string" }, "license_id": { "format": "uuid", "type": "string" } }, "required": [ "activation_id", "activation_code", "expires_at", "license_id" ], "type": "object" }, "TranslationCheck": { "additionalProperties": false, "properties": { "connected": { "type": "boolean" }, "languages": { "items": { "$ref": "#/components/schemas/TranslationLanguage" }, "type": "array" }, "provider_usage": { "additionalProperties": false, "properties": { "character_count": { "type": "integer" }, "character_limit": { "type": "integer" } }, "required": [ "character_count", "character_limit" ], "type": "object" } }, "required": [ "connected", "languages", "provider_usage" ], "type": "object" }, "TranslationLanguage": { "additionalProperties": false, "properties": { "lang": { "description": "Kode target BCP 47 yang dikembalikan DeepL v3, seperti en-US atau zh-Hant.", "type": "string" }, "name": { "type": "string" }, "usable_as_target": { "type": "boolean" } }, "required": [ "lang", "name", "usable_as_target" ], "type": "object" }, "TranslationOptions": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" }, "languages": { "items": { "$ref": "#/components/schemas/TranslationLanguage" }, "type": "array" }, "provider": { "type": "string" } }, "required": [ "enabled", "languages", "provider" ], "type": "object" }, "TranslationSettings": { "additionalProperties": false, "properties": { "checked_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "enabled": { "type": "boolean" }, "key_configured": { "type": "boolean" }, "languages": { "items": { "$ref": "#/components/schemas/TranslationLanguage" }, "type": "array" }, "local_usage": { "$ref": "#/components/schemas/TranslationUsage" }, "monthly_limit": { "description": "Anggaran karakter bulanan lokal, independen dari kuota akun DeepL dan tanggal penagihan.", "type": "integer" }, "requests_per_minute": { "type": "integer" }, "tier": { "enum": [ "free", "pro" ], "type": "string" }, "version": { "type": "string" } }, "required": [ "enabled", "tier", "key_configured", "monthly_limit", "requests_per_minute", "languages", "checked_at", "version", "local_usage" ], "type": "object" }, "TranslationSettingsInput": { "additionalProperties": false, "properties": { "api_key": { "description": "Disimpan terenkripsi. Kosong mempertahankan kunci tersimpan kecuali clear_key bernilai true. Perubahan kunci/tingkat memerlukan pemeriksaan koneksi berhasil lagi.", "maxLength": 1000, "type": "string", "writeOnly": true }, "clear_key": { "type": "boolean" }, "enabled": { "type": "boolean" }, "expected_version": { "type": "string" }, "monthly_limit": { "maximum": 1000000000, "minimum": 1, "type": "integer" }, "requests_per_minute": { "maximum": 60, "minimum": 1, "type": "integer" }, "tier": { "enum": [ "free", "pro" ], "type": "string" } }, "required": [ "enabled", "tier", "monthly_limit", "requests_per_minute", "expected_version" ], "type": "object" }, "TranslationUsage": { "additionalProperties": false, "properties": { "characters": { "description": "Karakter berhasil yang ditagih ditambah reservasi konservatif untuk permintaan dengan hasil tidak diketahui. Cache hit tidak menambah penggunaan.", "type": "integer" }, "month": { "description": "Bulan kalender UTC YYYY-MM.", "type": "string" } }, "required": [ "month", "characters" ], "type": "object" }, "Trial": { "additionalProperties": false, "properties": { "base_url": { "type": "string" }, "duration_days": { "const": 7, "type": "integer" }, "expires_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "isolated": { "type": "boolean" }, "key": { "type": "string", "writeOnly": true }, "license_id": { "format": "uuid", "type": "string" }, "product_id": { "format": "uuid", "type": "string" }, "trusted_keys": { "items": { "$ref": "#/components/schemas/SigningKey" }, "type": "array" } }, "required": [ "product_id", "license_id", "key", "trusted_keys" ], "type": "object" }, "UpgradeList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/PlanUpgrade" }, "type": "array" }, "total": { "description": "Total catatan yang cocok, bukan panjang halaman saat ini.", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "UpgradePart": { "additionalProperties": false, "description": "Perhitungan peningkatan yang dibekukan untuk satu periode prabayar saat ini atau masa depan. change.amount_cents adalah selisih periode ini; hanya penawaran parent yang menagih jumlah gabungan.", "properties": { "change": { "$ref": "#/components/schemas/PlanUpgrade", "description": "Perubahan harga dan hak untuk bagian peningkatan ini." }, "ends_at": { "description": "Stempel waktu akhir paket atau siklus, UTC; dapat null sebelum aktivasi.", "format": "date-time", "type": "string" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "source": { "description": "Sumber hak, seperti purchase atau gift.", "enum": [ "purchase", "gift", "auto_renewal" ], "type": "string" }, "starts_at": { "description": "Stempel waktu mulai paket atau siklus, UTC.", "format": "date-time", "type": "string" } }, "required": [ "id", "source", "starts_at", "ends_at", "change" ], "type": "object" }, "UpgradeQuoteInput": { "additionalProperties": false, "properties": { "currency": { "pattern": "^[A-Z]{3}$", "type": "string" }, "plan": { "pattern": "^[a-z][a-z0-9_-]{0,63}$", "type": "string" }, "price_version": { "type": "string" }, "request_id": { "maxLength": 80, "type": "string" } }, "required": [ "plan", "currency", "price_version", "request_id" ], "type": "object" }, "Usage": { "additionalProperties": false, "properties": { "active_devices": { "description": "Untuk bulan UTC saat ini: hunian produk/perangkat terdaftar saat ini, independen dari riwayat penggunaan perangkat bulanan. Pendaftaran biasa tetap dihitung saat offline hingga dilepas. Sesi floating hanya dihitung selama lease valid dan dideduplikasi berdasarkan perangkat keras, dengan identitas perangkat sebagai cadangan. Pelepasan atau kedaluwarsa sesi floating terakhir mengembalikan kapasitas; pendaftaran valid berlanjut melewati batas bulan kuota. Pendaftaran uji coba SDK terisolasi dikecualikan. Untuk bulan UTC lain: riwayat penggunaan perangkat berbeda yang tercatat pada bulan tersebut.", "type": "integer" }, "api_calls": { "description": "Panggilan activate, validate, heartbeat, dan deactivate yang berhasil pada bulan UTC dan lingkungan pembayaran yang dipilih. Kegagalan, replay idempoten valid, pemeriksaan lokal, dan konsumsi fitur perangkat lunak dikecualikan. Untuk perbandingan jatah paket yang dibeli gunakan purchased.api_calls, yang mengikuti bulan kuota paket.", "type": "integer" }, "api_period": { "anyOf": [ { "$ref": "#/components/schemas/RuntimeAPIPeriod", "description": "Snapshot jatah API default untuk bulan UTC ini; dapat berupa null jika dinonaktifkan." }, { "description": "Snapshot jatah API default untuk bulan UTC ini; dapat berupa null jika dinonaktifkan.", "type": "null" } ], "description": "Jatah API default bulan UTC; null jika tidak tersedia. Dengan paket yang dibeli, gunakan purchased.api_calls dan purchased.included_api_calls untuk bulan kuota saat ini." }, "billable_devices": { "description": "Tanpa pembelian aktif pada bulan UTC saat ini, hunian perangkat saat ini di bawah jatah default. Untuk bulan tertutup atau cakupan prabayar, puncak penagihan periode default yang tersimpan. Estimasi menggunakan setidaknya puncak yang tercatat; pelepasan perangkat tidak mengembalikan biaya yang telah terjadi.", "type": "integer" }, "estimated_total_cents": { "description": "Estimasi biaya perangkat bulanan default dalam seperseratus unit mata uang.", "type": "integer" }, "estimated_total_micros": { "description": "Estimasi biaya perangkat bulanan default dalam sepersejuta; bukan agregat semua biaya paket.", "type": "integer" }, "month": { "description": "Bulan UTC YYYY-MM; nilai kueri yang dihilangkan menggunakan bulan saat ini. Job penagihan memerlukan bulan yang telah ditutup.", "type": "string" }, "operations": { "description": "Jumlah panggilan terukur yang berhasil dikelompokkan menurut activate, validate, heartbeat, dan deactivate.", "items": { "additionalProperties": false, "properties": { "count": { "description": "Jumlah dalam grup saat ini, atau jumlah catatan yang diproses batch.", "type": "integer" }, "operation": { "description": "Nama operasi; batch mendukung create/renew/revoke/apply_policy dan permintaan offline activate/deactivate.", "type": "string" } }, "required": [], "type": "object" }, "type": "array" }, "overage_devices": { "description": "Perangkat yang melebihi jatah yang disertakan.", "type": "integer" }, "period": { "anyOf": [ { "$ref": "#/components/schemas/Period", "description": "Snapshot penagihan bulanan UTC default; aturan meter menggunakan month/day/lifetime dan baris penggunaan menggunakan kunci periode konkret." }, { "description": "Snapshot penagihan bulanan UTC default; aturan meter menggunakan month/day/lifetime dan baris penggunaan menggunakan kunci periode konkret.", "type": "null" } ], "description": "Jatah penagihan UTC default/riwayat yang dibekukan. Null jika periode tersebut tidak ada dan penawaran default dinonaktifkan; pembelian aktif tetap dapat digunakan." }, "products": { "description": "Jumlah produk dalam ringkasan; kelompok penggunaan perangkat per produk dalam respons penggunaan.", "items": { "additionalProperties": false, "properties": { "active_devices": { "description": "Hunian saat ini per produk untuk bulan UTC saat ini; penggunaan perangkat berbeda historis untuk bulan UTC sebelumnya.", "type": "integer" }, "product_id": { "description": "UUID produk di ruang kerja saat ini.", "format": "uuid", "type": "string" } }, "required": [], "type": "object" }, "type": "array" }, "purchased": { "anyOf": [ { "$ref": "#/components/schemas/PlanPurchase", "description": "Paket bulan bergulir aktif saat ini, atau null." }, { "description": "Paket bulan bergulir aktif saat ini, atau null.", "type": "null" } ], "description": "Paket aktif di lingkungan pembayaran saat ini, hanya dikembalikan untuk bulan UTC saat ini. Kuota perangkat utama harus menggunakan purchased.included_devices, bukan period.included_devices." }, "purchased_active_devices": { "description": "Ketika purchased ada: hunian produk/perangkat terdaftar saat ini, independen dari riwayat penggunaan perangkat bulanan. Pendaftaran biasa tetap dihitung saat offline hingga dilepas. Sesi floating hanya dihitung selama lease valid dan dideduplikasi berdasarkan perangkat keras, dengan identitas perangkat sebagai cadangan. Pelepasan atau kedaluwarsa sesi floating terakhir mengembalikan kapasitas; pendaftaran valid berlanjut melewati batas bulan kuota. Pendaftaran uji coba SDK terisolasi dikecualikan.", "type": "integer" }, "sandbox": { "description": "Lingkungan sandbox.", "type": "boolean" }, "timezone": { "description": "Zona waktu agregasi penggunaan, UTC.", "type": "string" }, "warning": { "description": "normal, near_quota, atau quota_reached untuk jatah perangkat default.", "type": "string" } }, "required": [], "type": "object" }, "UsageDevice": { "additionalProperties": false, "properties": { "device_id": { "description": "Sidik jari perangkat bercakupan produk, biasanya 64 karakter heksadesimal huruf kecil, diturunkan oleh SDK.", "type": "string" }, "first_seen_at": { "description": "Stempel waktu aktivitas perangkat pertama pada bulan UTC ini.", "format": "date-time", "type": "string" }, "last_seen_at": { "description": "Stempel waktu aktivitas perangkat terakhir yang diamati server, UTC.", "format": "date-time", "type": "string" }, "month": { "description": "Bulan UTC YYYY-MM; nilai kueri yang dihilangkan menggunakan bulan saat ini. Job penagihan memerlukan bulan yang telah ditutup.", "type": "string" }, "product_id": { "description": "UUID produk di ruang kerja saat ini.", "format": "uuid", "type": "string" } }, "required": [], "type": "object" }, "UsageDeviceList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/UsageDevice" }, "type": "array" }, "limit": { "description": "Ukuran halaman, default 25, rentang 1–100.", "type": "integer" }, "offset": { "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "type": "integer" }, "total": { "description": "Total catatan yang cocok, bukan panjang halaman saat ini.", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "Verified": { "additionalProperties": false, "properties": { "verified": { "type": "boolean" } }, "required": [ "verified" ], "type": "object" }, "VersionedActivationReleaseInput": { "additionalProperties": false, "properties": { "expected_generation": { "description": "Generasi pengikatan yang ditampilkan dalam daftar perangkat saat ini. Wajib untuk pengikatan akun Launch; versi usang tidak pernah melepas pengikatan yang lebih baru.", "minimum": 1, "type": "integer" }, "operation_id": { "description": "UUID operasi stabil untuk pemulihan percobaan ulang. Wajib untuk pengikatan akun Launch.", "format": "uuid", "type": "string" } }, "required": [], "type": "object" }, "WaffoCheck": { "additionalProperties": false, "properties": { "connected": { "description": "enabled", "type": "boolean" }, "mode": { "description": "Lingkungan pembayaran. Catatan sandbox dan live diisolasi.", "enum": [ "sandbox", "live" ], "type": "string" } }, "required": [ "connected", "mode" ], "type": "object" }, "WaffoOrder": { "additionalProperties": false, "properties": { "amount_cents": { "description": "Harga layanan penuh yang dibekukan dalam unit mata uang terkecil; tanpa isi ulang dompet atau pembayaran campuran.", "type": "integer" }, "applied_at": { "anyOf": [ { "description": "Tenggat UTC untuk jendela pembuatan checkout asli.", "format": "date-time", "type": "string" }, { "type": "null" } ], "description": "Waktu UTC saat pembayaran terverifikasi mengaktifkan layanan atau mengkredit isi ulang dompet. purchase_id dan upgrade_id null mengidentifikasi isi ulang." }, "checkout_expires_at": { "description": "Tenggat UTC untuk jendela pembuatan checkout asli.", "format": "date-time", "type": "string" }, "created_at": { "description": "Tenggat UTC untuk jendela pembuatan checkout asli.", "format": "date-time", "type": "string" }, "currency": { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" }, "id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" }, "mode": { "description": "Lingkungan pembayaran. Catatan sandbox dan live diisolasi.", "enum": [ "sandbox", "live" ], "type": "string" }, "paid_at": { "anyOf": [ { "description": "Tenggat UTC untuk jendela pembuatan checkout asli.", "format": "date-time", "type": "string" }, { "type": "null" } ], "description": "Waktu UTC saat backend memverifikasi transaksi Waffo yang selesai." }, "provider_order_id": { "anyOf": [ { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" }, { "type": "null" } ], "description": "Pengenal ORD_ asli yang dipulihkan dari respons API terverifikasi." }, "purchase_id": { "anyOf": [ { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" }, { "type": "null" } ], "description": "Pembelian layanan atau perpanjangan tertunda yang ada; saling eksklusif dengan upgrade_id." }, "refunded_cents": { "description": "Harga layanan penuh yang dibekukan dalam unit mata uang terkecil; tanpa isi ulang dompet atau pembayaran campuran.", "type": "integer" }, "request_id": { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" }, "status": { "description": "Siklus hidup pembayaran, termasuk paid_unapplied ketika dana yang terkumpul memerlukan peninjauan operator dan pengembalian dana.", "enum": [ "creating", "created", "completed", "paid_unapplied", "partially_refunded", "refunded" ], "type": "string" }, "upgrade_id": { "anyOf": [ { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" }, { "type": "null" } ], "description": "Penawaran peningkatan tertunda yang ada; saling eksklusif dengan purchase_id." } }, "required": [ "id", "request_id", "mode", "provider_order_id", "purchase_id", "upgrade_id", "currency", "amount_cents", "refunded_cents", "status", "checkout_expires_at", "paid_at", "applied_at", "created_at" ], "type": "object" }, "WaffoOrderInput": { "additionalProperties": false, "description": "Bayar satu pembelian/peningkatan yang dibekukan, atau buat isi ulang dompet dengan jumlah dan mata uang tanpa ID layanan. request_id yang stabil mengembalikan pembayaran asli; perubahan intent, jumlah, atau mata uang ditolak. Hanya pembayaran selesai yang diverifikasi secara independen yang mengkredit dompet atau mengaktifkan layanan. Pengembalian isi ulang masuk ke dompet. Percobaan ulang menggunakan kembali kunci idempotensi penyedia asli hanya dalam jendela pembuatan checkout aslinya.", "oneOf": [ { "not": { "anyOf": [ { "required": [ "amount" ] }, { "required": [ "currency" ] } ] }, "properties": { "purchase_id": { "format": "uuid", "type": "string" }, "upgrade_id": { "type": "null" } }, "required": [ "purchase_id" ] }, { "not": { "anyOf": [ { "required": [ "amount" ] }, { "required": [ "currency" ] } ] }, "properties": { "purchase_id": { "type": "null" }, "upgrade_id": { "format": "uuid", "type": "string" } }, "required": [ "upgrade_id" ] }, { "properties": { "purchase_id": { "type": "null" }, "upgrade_id": { "type": "null" } }, "required": [ "amount", "currency" ] } ], "properties": { "amount": { "description": "Hanya wajib untuk isi ulang dompet. Jumlah tampilan desimal dalam batas yang dikonfigurasi. Pesanan layanan menolak jumlah dari klien.", "pattern": "^\\d+(?:\\.\\d{1,2})?$", "type": "string" }, "currency": { "description": "Hanya wajib untuk isi ulang dompet dan harus diaktifkan untuk penyedia ini.", "type": "string" }, "overage_accepted": { "description": "Otorisasi eksplisit terpisah untuk kelebihan penggunaan berbayar yang ditampilkan.", "type": "boolean" }, "policy_version": { "description": "Versi kebijakan tidak berubah yang saat ini diterbitkan. Wajib untuk tindakan yang dilindungi persetujuan setelah operator menerbitkan kebijakan, pada kedua lingkungan pembayaran.", "type": "string" }, "purchase_id": { "anyOf": [ { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" }, { "type": "null" } ], "description": "Pembelian layanan atau perpanjangan tertunda yang ada; saling eksklusif dengan upgrade_id." }, "request_id": { "description": "Kunci permintaan stabil yang dibuat pemanggil. Replay mengembalikan checkout asli.", "maxLength": 80, "type": "string" }, "terms_accepted": { "description": "Persetujuan eksplisit yang secara default tidak dicentang.", "type": "boolean" }, "upgrade_id": { "anyOf": [ { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" }, { "type": "null" } ], "description": "Penawaran peningkatan tertunda yang ada; saling eksklusif dengan purchase_id." } }, "required": [ "request_id" ], "type": "object" }, "WaffoOrderList": { "additionalProperties": false, "properties": { "items": { "description": "items", "items": { "$ref": "#/components/schemas/WaffoOrder" }, "type": "array" }, "total": { "description": "Harga layanan penuh yang dibekukan dalam unit mata uang terkecil; tanpa isi ulang dompet atau pembayaran campuran.", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "WaffoOrderResult": { "additionalProperties": false, "properties": { "approval_url": { "description": "URL checkout terautentikasi yang berumur pendek, atau kosong setelah pembayaran, kedaluwarsa, atau penonaktifan kanal. Jangan pernah mencatat atau menyimpannya dalam cache.", "type": "string" }, "order": { "$ref": "#/components/schemas/WaffoOrder", "description": "order" }, "return_url": { "description": "URL dasbor dompet untuk isi ulang, URL rekonsiliasi harga untuk pembayaran layanan. URL kembali saja tidak pernah membuktikan pembayaran.", "format": "uri", "type": "string" } }, "required": [ "order", "approval_url", "return_url" ], "type": "object" }, "WaffoSettings": { "additionalProperties": false, "properties": { "currencies": { "description": "currencies", "items": { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" }, "type": "array" }, "enabled": { "description": "enabled", "type": "boolean" }, "maximum_cents": { "description": "Isi ulang dompet maksimum dalam unit mata uang minor; default 100000 dan tidak boleh kurang dari minimum_cents.", "maximum": 100000000, "minimum": 1, "type": "integer" }, "merchant_id": { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" }, "minimum_cents": { "description": "Isi ulang dompet minimum dalam unit mata uang minor; default 100.", "maximum": 100000000, "minimum": 1, "type": "integer" }, "mode": { "description": "Lingkungan pembayaran. Catatan sandbox dan live diisolasi.", "enum": [ "sandbox", "live" ], "type": "string" }, "private_key_configured": { "description": "enabled", "type": "boolean" }, "product_id": { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" }, "store_id": { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" }, "version": { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" }, "webhook_public_key": { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" }, "webhook_url": { "description": "webhook url", "format": "uri", "type": "string" } }, "required": [ "enabled", "mode", "merchant_id", "store_id", "product_id", "currencies", "private_key_configured", "webhook_public_key", "version", "webhook_url" ], "type": "object" }, "WaffoSettingsInput": { "additionalProperties": false, "properties": { "clear_private_key": { "description": "enabled", "type": "boolean" }, "currencies": { "description": "currencies", "items": { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" }, "type": "array" }, "enabled": { "description": "enabled", "type": "boolean" }, "expected_version": { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" }, "maximum_cents": { "description": "Isi ulang dompet maksimum dalam unit mata uang minor; default 100000 dan tidak boleh kurang dari minimum_cents.", "maximum": 100000000, "minimum": 1, "type": "integer" }, "merchant_id": { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" }, "minimum_cents": { "description": "Isi ulang dompet minimum dalam unit mata uang minor; default 100.", "maximum": 100000000, "minimum": 1, "type": "integer" }, "mode": { "description": "Lingkungan pembayaran. Catatan sandbox dan live diisolasi.", "enum": [ "sandbox", "live" ], "type": "string" }, "private_key": { "description": "Kunci privat penandatanganan RSA. Dienkripsi saat disimpan; kosong mempertahankan kunci tersimpan.", "maxLength": 8192, "type": "string", "writeOnly": true }, "product_id": { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" }, "store_id": { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" }, "webhook_public_key": { "description": "Override kunci publik webhook resmi opsional. Kosong menggunakan kunci SDK untuk lingkungan yang dipilih.", "maxLength": 8192, "type": "string" } }, "required": [ "enabled", "mode", "merchant_id", "store_id", "product_id", "currencies", "expected_version" ], "type": "object" }, "WaffoWebhookEvent": { "description": "Peristiwa Waffo mentah yang diautentikasi dengan X-Waffo-Signature, kunci publik lingkungan yang dipilih, store, dan mode. Pembayaran/pengembalian dana diverifikasi secara independen melalui API.", "type": "object" }, "Wallet": { "additionalProperties": false, "properties": { "balance_cents": { "description": "Saldo dompet, atau saldo setelah entri, dalam seperseratus.", "type": "integer" }, "currency": { "description": "Kode mata uang huruf besar tiga huruf, seperti USD.", "pattern": "^[A-Z]{3}$", "type": "string" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "sandbox", "live" ], "type": "string" } }, "required": [], "type": "object" }, "WalletEntry": { "additionalProperties": false, "properties": { "amount_cents": { "description": "Jumlah dalam seperseratus; entri ledger dapat berupa kredit positif atau debit negatif.", "type": "integer" }, "balance_cents": { "description": "Saldo dompet, atau saldo setelah entri, dalam seperseratus.", "type": "integer" }, "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "currency": { "description": "Kode mata uang huruf besar tiga huruf, seperti USD.", "pattern": "^[A-Z]{3}$", "type": "string" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "kind": { "description": "plan_upgrade mencatat peningkatan berbayar. paypal_refund_reserve menahan dana dompet yang tersedia; paypal_refund_release menghapus penahanan tersebut; paypal_refund mencatat pengembalian tunai yang dikonfirmasi. Pergerakan reserve/release bukan pembayaran tunai dan saling meniadakan saat penyelesaian selesai.", "type": "string" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "sandbox", "live" ], "type": "string" }, "reference": { "description": "Referensi bisnis terkait yang digunakan untuk pelacakan.", "type": "string" } }, "required": [], "type": "object" }, "WalletEntryList": { "additionalProperties": false, "properties": { "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/WalletEntry" }, "type": "array" }, "limit": { "description": "Ukuran halaman, default 25, rentang 1–100.", "type": "integer" }, "offset": { "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "type": "integer" }, "total": { "description": "Total catatan yang cocok, bukan panjang halaman saat ini.", "type": "integer" } }, "required": [], "type": "object" }, "WalletRefundRequest": { "additionalProperties": false, "properties": { "amount_cents": { "minimum": 1, "type": "integer" }, "created_at": { "format": "date-time", "type": "string" }, "currency": { "type": "string" }, "customer_email": { "description": "Hanya daftar administrator.", "type": "string" }, "decision": { "type": "string" }, "id": { "format": "uuid", "type": "string" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "order_id": { "format": "uuid", "type": "string" }, "reason": { "type": "string" }, "refund_id": { "format": "uuid", "type": [ "string", "null" ] }, "refund_status": { "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "review_status": { "enum": [ "pending", "approved", "declined", "cancelled" ], "type": "string" }, "reviewed_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "status": { "enum": [ "pending_review", "refund_pending", "refunded", "refund_failed", "declined", "cancelled" ], "type": "string" }, "tenant_name": { "description": "Hanya daftar administrator.", "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "id", "order_id", "mode", "currency", "amount_cents", "reason", "status", "review_status" ], "type": "object" }, "WalletRefundRequestInput": { "additionalProperties": false, "properties": { "amount": { "description": "Jumlah positif, dibatasi oleh nilai pesanan yang belum dikembalikan dan kredit dompet saat ini yang belum dibelanjakan.", "pattern": "^[0-9]+(?:\\.[0-9]{1,2})?$", "type": "string" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "reason": { "maxLength": 255, "minLength": 1, "type": "string" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "amount", "reason", "request_id", "mode" ], "type": "object" }, "WalletRefundRequestList": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/WalletRefundRequest" }, "type": "array" }, "limit": { "type": "integer" }, "mode": { "enum": [ "sandbox", "live" ], "type": "string" }, "offset": { "type": "integer" }, "total": { "type": "integer" } }, "required": [ "items", "total", "mode" ], "type": "object" }, "WalletRefundReview": { "additionalProperties": false, "properties": { "approve": { "type": "boolean" }, "decision": { "maxLength": 1000, "minLength": 1, "type": "string" }, "expected_updated_at": { "format": "date-time", "type": "string" } }, "required": [ "approve", "decision" ], "type": "object" }, "WalletResult": { "additionalProperties": false, "properties": { "currencies": { "description": "Kode mata uang yang diizinkan di lingkungan ini.", "items": { "pattern": "^[A-Z]{3}$", "type": "string" }, "type": "array" }, "items": { "description": "Catatan yang dikembalikan; lihat items[] untuk bidang elemen. Sebagian koleksi kosong dapat berupa null; lihat type.", "items": { "$ref": "#/components/schemas/Wallet" }, "type": "array" }, "maximum_cents": { "description": "Isi ulang maksimum untuk kanal isi ulang dompet yang aktif, dalam unit minor.", "type": "integer" }, "minimum_cents": { "description": "Isi ulang minimum untuk kanal isi ulang dompet yang aktif, dalam unit minor.", "type": "integer" }, "mode": { "description": "Jangka waktu lisensi: perpetual, timed, atau trial; objek penagihan menggunakan mode pembayaran sandbox atau live.", "enum": [ "sandbox", "live" ], "type": "string" }, "payment_channels": { "description": "Konfigurasi kanal pembayaran yang tersedia. Tampilkan hanya kanal aktif yang cocok dengan lingkungan penagihan aktif dan mata uang pembelian.", "items": { "$ref": "#/components/schemas/PaymentChannel" }, "type": "array" }, "paypal_enabled": { "description": "Apakah PayPal diaktifkan di lingkungan pembayaran ini.", "type": "boolean" } }, "required": [], "type": "object" }, "WebhookAttempt": { "additionalProperties": false, "properties": { "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "delivery_id": { "description": "UUID tugas pengiriman untuk percobaan ini.", "format": "uuid", "type": "string" }, "duration_ms": { "description": "Durasi pengiriman dalam milidetik.", "type": "integer" }, "error": { "description": "Objek kesalahan atau kategori kegagalan pengiriman; lihat bidang turunan atau jenis saat ini.", "type": "string" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "number": { "description": "Nomor urut percobaan kumulatif.", "type": "integer" }, "status_code": { "description": "Status HTTP untuk percobaan ini; dapat 0 pada kegagalan transport.", "type": "integer" } }, "required": [ "id", "delivery_id", "number", "status_code", "error", "duration_ms", "created_at" ], "type": "object" }, "WebhookDelivery": { "additionalProperties": false, "properties": { "attempts": { "description": "Jumlah kumulatif percobaan tugas.", "type": "integer" }, "available_at": { "description": "Waktu UTC paling awal tugas dapat dijalankan.", "format": "date-time", "type": "string" }, "created_at": { "description": "Waktu pembuatan dalam UTC; permintaan offline menggunakan detik Unix.", "format": "date-time", "type": "string" }, "delivered_at": { "anyOf": [ { "description": "Stempel waktu pengiriman berhasil, atau null.", "format": "date-time", "type": "string" }, { "description": "Stempel waktu pengiriman berhasil, atau null.", "type": "null" } ], "description": "Stempel waktu pengiriman berhasil, atau null." }, "endpoint_id": { "description": "UUID endpoint webhook.", "format": "uuid", "type": "string" }, "event_id": { "description": "UUID peristiwa asli; gunakan untuk deduplikasi penerima.", "format": "uuid", "type": "string" }, "id": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" }, "last_error": { "description": "Kategori kegagalan terbaru; boleh kosong.", "type": "string" }, "last_status": { "description": "Status respons HTTP terbaru; dapat 0 jika tidak ada respons yang tiba.", "type": "integer" }, "status": { "description": "Status resource saat ini; lihat enum dan catatan operasi.", "type": "string" } }, "required": [ "id", "endpoint_id", "event_id", "status", "attempts", "available_at", "last_status", "last_error", "delivered_at", "created_at" ], "type": "object" }, "WebhookEvent": { "description": "Peristiwa PayPal bertanda tangan yang tepat, diverifikasi dengan API PayPal", "type": "object" }, "WebhookReceived": { "additionalProperties": false, "properties": { "ignored": { "type": "boolean" }, "received": { "type": "boolean" } }, "required": [], "type": "object" } }, "securitySchemes": { "closureExport": { "description": "Kredensial unduhan terbatas 15 menit, bukan sesi dasbor. Produksi menggunakan __Host-licentivo_closure_export; selalu dibatasi oleh tenggat penutupan asli.", "in": "cookie", "name": "licentivo_closure_export", "type": "apiKey" }, "customerSession": { "description": "Produksi menggunakan __Host-licenova_customer; identitas pembeli independen dari sesi vendor.", "in": "cookie", "name": "licenova_customer", "type": "apiKey" }, "managementKey": { "bearerFormat": "lv_api_...", "scheme": "bearer", "type": "http" }, "session": { "description": "Produksi menggunakan __Host-licenova_session", "in": "cookie", "name": "licenova_session", "type": "apiKey" } } }, "info": { "description": "API manajemen dan lisensi Licentivo. Mendukung grant runtime bertanda tangan, lisensi node-locked dan floating, kuota perangkat aktivasi saat ini, penggunaan API bulanan, fitur perangkat lunak terukur, sesi akun Launch, paket prabayar, hadiah, perpanjangan otomatis dompet, dan peningkatan seluruh cakupan. PayPal, Paddle, dan Waffo mendukung pembayaran terverifikasi dan pengembalian dana melalui jalur semula. Termasuk kebijakan pelanggan, pembatalan dengan cakupan persetujuan, dukungan, kompensasi, ekspor data, dan penutupan akun logis. Lingkungan pembayaran dan mata uang diisolasi; kredensial privat dienkripsi dan tidak pernah dikembalikan.", "title": "API Licentivo", "version": "0.12.0", "x-document-language": "id" }, "openapi": "3.1.0", "paths": { "/api/v1/account/closure-export.zip": { "get": { "description": "Kredensial dan tenggat penutupan asli diperiksa ulang untuk setiap permintaan dan setelah pembuatan. Memulihkan cadangan tidak dapat memulai ulang periode tersebut.", "operationId": "get__api_v1_account_closure_export_zip", "parameters": [], "responses": { "200": { "content": { "application/zip": { "schema": { "format": "binary", "type": "string" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "closureExport": [] } ], "summary": "Unduh selama periode penutupan 30 hari" } }, "/api/v1/account/closure-export/session": { "post": { "description": "Memerlukan email/kata sandi asli yang terverifikasi dan penutupan terkonfirmasi yang masih dalam tepat 30 hari. Cookie 15 menit dibatasi oleh tenggat asli, dikenai pembatasan laju, dan tidak dapat mengotorisasi akses API/dasbor normal.", "operationId": "post__api_v1_account_closure_export_session", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClosureExportLogin" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ClosureExportCredential" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [], "summary": "Verifikasi akun tertutup untuk ekspor terbatas" } }, "/api/v1/account/data-export": { "get": { "description": "Unduhan Owner mencakup CSV bisnis ruang kerja. Arsip pribadi anggota berisi profil, posting, dan permintaannya sendiri. Rahasia/hash kredensial dan kunci privat penandatanganan dikecualikan.", "operationId": "get__api_v1_account_data_export", "parameters": [], "responses": { "200": { "content": { "application/zip": { "schema": { "format": "binary", "type": "string" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Unduh data pribadi dan data yang diotorisasi milik sendiri", "x-required-role": "session" } }, "/api/v1/account/deletions": { "get": { "description": "", "operationId": "get__api_v1_account_deletions", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/AccountClosureList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca permintaan penutupan logis sendiri", "x-required-role": "session" }, "post": { "description": "Penutupan oleh Owner harus memilih ruang kerja; anggota hanya dapat menutup akunnya sendiri. Konfirmasi mencabut sesi/kunci API tetapi mempertahankan data. Ekspor diizinkan selama 30 hari setelah konfirmasi.", "operationId": "post__api_v1_account_deletions", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountClosureInput" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/AccountClosure" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Minta penutupan logis akun atau ruang kerja", "x-required-role": "session" } }, "/api/v1/account/deletions/{id}/cancel": { "post": { "description": "", "operationId": "post__api_v1_account_deletions__id__cancel", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CommerceResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Tarik permintaan penutupan yang belum dikonfirmasi", "x-required-role": "session" } }, "/api/v1/account/legal-acceptances": { "get": { "description": "", "operationId": "get__api_v1_account_legal_acceptances", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LegalAcceptanceList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca tanda terima persetujuan hukum sendiri", "x-required-role": "session" } }, "/api/v1/account/profile": { "patch": { "description": "Memerlukan kata sandi saat ini. Email login baru menerima tautan verifikasi sekali pakai yang berlaku selama 30 menit. Email login terverifikasi saat ini dan akses tetap tidak berubah sampai konfirmasi.", "operationId": "patch__api_v1_account_profile", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountCorrection" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CommerceResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Perbaiki nama sendiri atau minta perubahan email login", "x-required-role": "session" } }, "/api/v1/activate": { "post": { "description": "Diautentikasi dengan product_id + license_key + device_id. Tanpa cookie/CSRF/kunci vendor. activation_id wajib kecuali untuk activate. Setiap permintaan berhasil mengonsumsi satu panggilan API; replay idempoten dan kegagalan tidak. Kelebihan penggunaan mendebit dompet secara atomik atau mengembalikan API_QUOTA_EXCEEDED/API_BALANCE_INSUFFICIENT. Kuota perangkat ruang kerja mengikuti aktivasi saat ini. Pelepasan mengembalikan kapasitas; kedaluwarsa lease floating juga mengembalikan kapasitas, sedangkan pendaftaran biasa yang offline tetap dihitung. Kelebihan perangkat hanya ditagih ketika puncak penagihan bulan kuota meningkat melampaui kapasitas yang sudah dibayar; pelepasan tidak mengembalikan biaya yang telah terjadi. Penggunaan API terpisah.", "operationId": "post_api_v1_activate", "parameters": [ { "description": "Buat kunci baru untuk setiap operasi; percobaan ulang mempertahankan kunci dan isi yang sama. Maksimum 80 karakter, tanpa spasi. Opsional untuk validasi dan heartbeat.", "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 80, "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RuntimeInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/RuntimeResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "Aktivasi runtime" } }, "/api/v1/activations": { "get": { "operationId": "get_api_v1_activations", "parameters": [ { "in": "query", "name": "limit", "schema": { "default": 25, "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "maximum": 100000, "minimum": 0, "type": "integer" } }, { "in": "query", "name": "license_id", "schema": { "description": "UUID lisensi, berbeda dari rahasia lv_lic_.", "format": "uuid", "type": "string" } }, { "in": "query", "name": "product_id", "schema": { "description": "UUID produk di ruang kerja saat ini.", "format": "uuid", "type": "string" } }, { "in": "query", "name": "status", "schema": { "description": "Status resource saat ini; lihat enum dan catatan operasi.", "enum": [ "active", "released" ], "type": "string" } }, { "in": "query", "name": "q", "schema": { "description": "Teks pencarian; bidang target dan panjang maksimum bergantung pada operasi.", "maxLength": 120, "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "created_at": "2026-10-18T00:00:00Z", "device_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "device_name": "Office PC", "generation": 1, "id": "44444444-4444-4444-8444-444444444444", "last_seen_at": "2026-10-18T00:00:00Z", "license_id": "33333333-3333-4333-8333-333333333333", "product_id": "11111111-1111-4111-8111-111111111111", "released_at": null, "status": "active", "virtual_machine": false } ], "limit": 25, "offset": 0, "total": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ActivationList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar aktivasi", "x-management-reference": { "group": "devices" }, "x-required-scope": "read" } }, "/api/v1/activations/{id}/release": { "post": { "operationId": "post_api_v1_activations_by_id_release", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "expected_generation": 1, "operation_id": "11111111-1111-4111-8111-111111111111" }, "schema": { "$ref": "#/components/schemas/VersionedActivationReleaseInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333", "status": "released" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/StateResult", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Lepas aktivasi", "x-management-reference": { "group": "devices" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/api-keys": { "get": { "operationId": "get_api_v1_api-keys", "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "allow_http": false, "created_at": "2026-10-18T00:00:00Z", "expires_at": "2026-10-18T00:00:00Z", "id": "33333333-3333-4333-8333-333333333333", "name": "Report app", "prefix": "lv_api_AAAAAAA", "revoked": false, "scope": "read" } ], "limit": 25, "offset": 0, "total": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/KeyList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "Daftar kunci API", "x-management-reference": { "group": "keys" }, "x-required-role": "owner", "x-required-scope": "owner_session" }, "post": { "operationId": "post_api_v1_api-keys", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "description": "Wajib untuk penulisan yang diautentikasi cookie; dapatkan data.csrf_token dari GET /api/v1/auth/csrf dan pertahankan cookie.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "allow_http": false, "expires_days": 90, "name": "Order system", "scope": "write" }, "schema": { "$ref": "#/components/schemas/KeyCreate" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "example": { "data": { "expires_at": "2027-01-16T00:00:00Z", "id": "33333333-3333-4333-8333-333333333333", "key": "lv_api_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "prefix": "lv_api_AAAAAAA" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/KeySecret", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "Buat kunci API", "x-management-reference": { "group": "keys" }, "x-required-role": "owner", "x-required-scope": "owner_session" } }, "/api/v1/api-keys/{id}": { "delete": { "operationId": "delete_api_v1_api-keys_by_id", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "description": "Wajib untuk penulisan yang diautentikasi cookie; dapatkan data.csrf_token dari GET /api/v1/auth/csrf dan pertahankan cookie.", "type": "string" } }, { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ID", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "Cabut kunci API", "x-management-reference": { "group": "keys" }, "x-required-role": "owner", "x-required-scope": "owner_session" }, "patch": { "description": "Memerlukan sesi Owner dan token CSRF. Hanya memperbarui kunci aktif ini; rotasi mempertahankan pengaturan. Tidak mengubah koneksi Launch atau grant runtime yang ada. Pengaturan ini tidak mengaktifkan HTTP pada API Licentivo.", "operationId": "patch_api_v1_api-keys_by_id", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "description": "Wajib untuk penulisan yang diautentikasi cookie; dapatkan data.csrf_token dari GET /api/v1/auth/csrf dan pertahankan cookie.", "type": "string" } }, { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "allow_http": true }, "schema": { "$ref": "#/components/schemas/KeyUpdate" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "allow_http": false, "id": "33333333-3333-4333-8333-333333333333" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/KeyUpdated", "description": "Response data for the completed operation." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "Perbarui akses HTTP untuk situs", "x-management-reference": { "group": "keys" }, "x-required-role": "owner", "x-required-scope": "owner_session" } }, "/api/v1/api-keys/{id}/rotate": { "post": { "operationId": "post_api_v1_api-keys_by_id_rotate", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "description": "Wajib untuk penulisan yang diautentikasi cookie; dapatkan data.csrf_token dari GET /api/v1/auth/csrf dan pertahankan cookie.", "type": "string" } }, { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": {}, "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333", "key": "lv_api_BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB", "prefix": "lv_api_BBBBBBB" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/KeyRotated", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "Rotasi kunci API", "x-management-reference": { "group": "keys" }, "x-required-role": "owner", "x-required-scope": "owner_session" } }, "/api/v1/audit-logs": { "get": { "operationId": "get_api_v1_audit-logs", "parameters": [ { "in": "query", "name": "limit", "schema": { "default": 25, "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "maximum": 100000, "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "action": "license.create", "actor_id": "33333333-3333-4333-8333-333333333333", "actor_kind": "api_key", "created_at": "2026-10-18T00:00:00Z", "id": "33333333-3333-4333-8333-333333333333", "request_id": "55555555-5555-4555-8555-555555555555", "resource_id": "" } ], "limit": 25, "offset": 0 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/AuditList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar log audit", "x-management-reference": { "group": "usage" }, "x-required-scope": "read" } }, "/api/v1/auth/accept-invitation": { "post": { "operationId": "post_api_v1_auth_accept-invitation", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenPassword" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PasswordSet" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "accept-invitation" } }, "/api/v1/auth/change-password": { "post": { "operationId": "post_api_v1_auth_change-password", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChangePassword" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PasswordSet" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "Cabut semua kredensial akun dan tetapkan kata sandi" } }, "/api/v1/auth/confirm-email-change": { "post": { "description": "Verifikasi challenge sekali pakai yang terenkripsi. Hanya konfirmasi berhasil yang mengubah dan memverifikasi email login serta mencabut sesi, kunci API, dan tautan autentikasi yang ada. Challenge yang kedaluwarsa, diganti, atau dibatalkan oleh perubahan kata sandi tidak dapat mengubah akun.", "operationId": "post__api_v1_auth_confirm_email_change", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailChangeConfirmation" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CommerceResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [], "summary": "Konfirmasi email login baru" } }, "/api/v1/auth/csrf": { "get": { "operationId": "get_api_v1_auth_csrf", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CSRF" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "Terbitkan token CSRF yang terikat pada sesi" } }, "/api/v1/auth/forgot-password": { "post": { "operationId": "post_api_v1_auth_forgot-password", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Email" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Notice" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "forgot-password" } }, "/api/v1/auth/login": { "post": { "operationId": "post_api_v1_auth_login", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Login" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CSRF" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "login" } }, "/api/v1/auth/logout": { "post": { "operationId": "post_api_v1_auth_logout", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LoggedOut" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "Cabut sesi saat ini" } }, "/api/v1/auth/me": { "get": { "operationId": "get_api_v1_auth_me", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Me" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "Akun cookie saat ini" } }, "/api/v1/auth/register": { "post": { "description": " Ketentuan yang diterbitkan memerlukan policy_version dan persetujuan eksplisit di kedua lingkungan pembayaran. Kelebihan penggunaan layanan berbayar juga memerlukan overage_accepted. Sebelum publikasi kebijakan pertama, persetujuan draf tidak dicatat dan setiap operasi tetap mengikuti pemeriksaan pendaftaran, harga, dan pembayaran normalnya.", "operationId": "post_api_v1_auth_register", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Register" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Notice" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "register" } }, "/api/v1/auth/resend-verification": { "post": { "operationId": "post_api_v1_auth_resend-verification", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Email" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Notice" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "resend-verification" } }, "/api/v1/auth/reset-password": { "post": { "operationId": "post_api_v1_auth_reset-password", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenPassword" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PasswordSet" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "reset-password" } }, "/api/v1/auth/verify-email": { "post": { "operationId": "post_api_v1_auth_verify-email", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Token" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Verified" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "verify-email" } }, "/api/v1/billing/auto-renewal": { "get": { "description": "Hanya sesi. PATCH memerlukan Owner ruang kerja. Default dinonaktifkan. Pengaktifan memerlukan saldo mode dan mata uang saat ini yang cukup untuk satu perpanjangan, serta paket berbayar terbaru, jangka waktu yang ditawarkan, dan versi harga yang telah ditinjau. Saat kedaluwarsa hanya dana dompet yang ditagih, bukan PayPal atau kartu. Worker per menit dan mutasi runtime memproses perpanjangan jatuh tempo di bawah kunci tenant. Percobaan berulang menagih satu kali. Dana tidak cukup menunggu isi ulang; perubahan harga, paket, atau ketersediaan menjeda penagihan hingga ada persetujuan baru. Penonaktifan membatalkan penagihan otomatis berikutnya, bukan cakupan yang telah dibayar.", "operationId": "get_api_v1_billing_auto_renewal", "parameters": [], "responses": { "200": { "content": { "application/json": { "example": { "data": { "next_renewal_at": null, "setting": { "amount_cents": 0, "currency": "USD", "enabled": true, "mode": "sandbox", "plan": "starter", "plan_name": "Starter", "policy_version": "", "price_version": "example-v1", "status": "disabled", "term_months": 1, "updated_at": "2026-10-18T00:00:00Z", "version": "" } }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/AutoRenewalResult", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "example": { "error": { "code": "DEFAULT_PLAN_DISABLED", "message": "The default allowance plan has not been enabled by the administrator" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Baca pengaturan perpanjangan otomatis", "x-management-reference": { "group": "billing" }, "x-required-scope": "read" }, "patch": { "description": "Hanya sesi. PATCH memerlukan Owner ruang kerja. Default dinonaktifkan. Pengaktifan memerlukan saldo mode dan mata uang saat ini yang cukup untuk satu perpanjangan, serta paket berbayar terbaru, jangka waktu yang ditawarkan, dan versi harga yang telah ditinjau. Saat kedaluwarsa hanya dana dompet yang ditagih, bukan PayPal atau kartu. Worker per menit dan mutasi runtime memproses perpanjangan jatuh tempo di bawah kunci tenant. Percobaan berulang menagih satu kali. Dana tidak cukup menunggu isi ulang; perubahan harga, paket, atau ketersediaan menjeda penagihan hingga ada persetujuan baru. Penonaktifan membatalkan penagihan otomatis berikutnya, bukan cakupan yang telah dibayar. Ketentuan yang diterbitkan memerlukan policy_version dan persetujuan eksplisit di kedua lingkungan pembayaran. Kelebihan penggunaan layanan berbayar juga memerlukan overage_accepted. Sebelum publikasi kebijakan pertama, persetujuan draf tidak dicatat dan setiap operasi tetap mengikuti pemeriksaan pendaftaran, harga, dan pembayaran normalnya.", "operationId": "patch_api_v1_billing_auto_renewal", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AutoRenewalInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/AutoRenewal" }, "request_id": { "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Aktifkan atau nonaktifkan perpanjangan dompet yang disetujui secara eksplisit" } }, "/api/v1/billing/invoices": { "get": { "operationId": "get_api_v1_billing_invoices", "parameters": [ { "in": "query", "name": "limit", "schema": { "default": 25, "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "maximum": 100000, "minimum": 0, "type": "integer" } }, { "in": "query", "name": "month", "schema": { "description": "Bulan UTC YYYY-MM; nilai kueri yang dihilangkan menggunakan bulan saat ini. Job penagihan memerlukan bulan yang telah ditutup.", "pattern": "^[0-9]{4}-[0-9]{2}$", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "active_devices": 0, "base_covered": false, "base_micros": 0, "created_at": "2026-10-18T00:00:00Z", "currency": "USD", "finalized_at": null, "id": "33333333-3333-4333-8333-333333333333", "included_devices": 0, "month": "2026-09", "overage_devices": 0, "paid_at": null, "payment_mode": "sandbox", "plan": "starter", "plan_name": "Starter", "price_version": "example-v1", "refunded_at": null, "status": "draft", "total_cents": 0, "total_micros": 0, "unit_micros": 0, "voided_at": null } ], "limit": 25, "offset": 0, "total": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/InvoiceList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar faktur", "x-management-reference": { "group": "billing" }, "x-required-scope": "read" } }, "/api/v1/billing/invoices/{id}": { "get": { "operationId": "get_api_v1_billing_invoices_by_id", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "active_devices": 0, "base_covered": false, "base_micros": 0, "created_at": "2026-10-18T00:00:00Z", "currency": "USD", "finalized_at": null, "id": "33333333-3333-4333-8333-333333333333", "included_devices": 0, "month": "2026-09", "overage_devices": 0, "paid_at": null, "payment_mode": "sandbox", "plan": "starter", "plan_name": "Starter", "price_version": "example-v1", "refunded_at": null, "status": "draft", "total_cents": 0, "total_micros": 0, "unit_micros": 0, "voided_at": null }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Invoice", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Baca faktur", "x-management-reference": { "group": "billing" }, "x-required-scope": "read" } }, "/api/v1/billing/invoices/{id}/export.csv": { "get": { "operationId": "get_api_v1_billing_invoices_by_id_export_csv", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "text/csv": { "example": "invoice_id,month,currency,status,plan,price_version,active_devices,included_devices,overage_devices,base_micros,unit_micros,total_micros,total_cents\n", "schema": { "type": "string" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Ekspor faktur", "x-csv-columns": [ "invoice_id", "month", "currency", "status", "plan", "price_version", "active_devices", "included_devices", "overage_devices", "base_micros", "unit_micros", "total_micros", "total_cents" ], "x-management-reference": { "group": "billing" }, "x-required-scope": "read" } }, "/api/v1/billing/invoices/{id}/finalize": { "post": { "operationId": "post_api_v1_billing_invoices_by_id_finalize", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": {}, "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333", "status": "finalized" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/StateResult", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Finalisasi faktur", "x-management-reference": { "group": "billing" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/billing/invoices/{id}/pay": { "post": { "description": " Persetujuan eksplisit terhadap kebijakan saat ini diperlukan sebelum pembayaran baru. Replay yang sudah dibayar mempertahankan tanda terima aslinya.", "operationId": "post_api_v1_billing_invoices_by_id_pay", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } }, { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LegalConsent" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Invoice" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "Bayar faktur historis yang telah dikonfirmasi dari saldo", "x-required-role": "owner" } }, "/api/v1/billing/invoices/{id}/void": { "post": { "operationId": "post_api_v1_billing_invoices_by_id_void", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": {}, "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333", "status": "void" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/StateResult", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Batalkan faktur", "x-management-reference": { "group": "billing" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/billing/jobs": { "get": { "operationId": "get_api_v1_billing_jobs", "parameters": [ { "in": "query", "name": "limit", "schema": { "default": 25, "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "maximum": 100000, "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "attempts": 0, "available_at": "2026-10-18T00:00:00Z", "created_at": "2026-10-18T00:00:00Z", "id": "33333333-3333-4333-8333-333333333333", "last_error": "", "month": "2026-09", "status": "pending" } ], "limit": 25, "offset": 0, "total": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/BillingJobList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar job penagihan", "x-management-reference": { "group": "billing" }, "x-required-scope": "read" }, "post": { "operationId": "post_api_v1_billing_jobs", "parameters": [], "requestBody": { "content": { "application/json": { "example": { "month": "2026-09" }, "schema": { "$ref": "#/components/schemas/MonthInput" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "example": { "data": { "attempts": 0, "available_at": "2026-10-18T00:00:00Z", "created_at": "2026-10-18T00:00:00Z", "id": "33333333-3333-4333-8333-333333333333", "last_error": "", "month": "2026-09", "status": "pending" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/BillingJob", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Antrekan job penagihan", "x-management-reference": { "group": "billing" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/billing/jobs/{id}/retry": { "post": { "operationId": "post_api_v1_billing_jobs_by_id_retry", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": {}, "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333", "status": "pending" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/StateResult", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Coba ulang job penagihan", "x-management-reference": { "group": "billing" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/billing/notification-preferences": { "get": { "description": "Hanya sesi Owner; kunci manajemen ditolak. Default aktif untuk keempat jenis dan zh sampai disimpan secara eksplisit. Preferensi milik pengguna dan ruang kerja ini. Menggunakan kembali transport email autentikasi, pengirim, antrean persisten terenkripsi, dan percobaan ulang. Izin platform dan persetujuan penerima harus sama-sama mengizinkan suatu jenis. Pengiriman memeriksa ulang persetujuan dan status peristiwa saat ini. Pilihan email tidak memberikan atau mencabut persetujuan untuk mendebit dompet. Pesan sandbox diberi label. Tidak ada notifikasi untuk pembelian tertunda yang belum dibayar atau hadiah.", "operationId": "get__api_v1_billing_notification_preferences", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/BillingNotificationPreferencesResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca persetujuan email owner saat ini", "x-required-role": "owner" }, "patch": { "description": "Pembaruan parsial untuk owner sesi; tidak dapat menargetkan pengguna lain. Locale mengendalikan pesan berikutnya. Email verifikasi dan keamanan yang ada tetap independen. Menggunakan kembali transport email autentikasi, pengirim, antrean persisten terenkripsi, dan percobaan ulang. Izin platform dan persetujuan penerima harus sama-sama mengizinkan suatu jenis. Pengiriman memeriksa ulang persetujuan dan status peristiwa saat ini. Pilihan email tidak memberikan atau mencabut persetujuan untuk mendebit dompet. Pesan sandbox diberi label. Tidak ada notifikasi untuk pembelian tertunda yang belum dibayar atau hadiah.", "operationId": "patch__api_v1_billing_notification_preferences", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BillingNotificationPreferenceInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/BillingNotificationPreference" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Simpan persetujuan email owner saat ini", "x-required-role": "owner" } }, "/api/v1/billing/overage-consent": { "post": { "description": "", "operationId": "post__api_v1_billing_overage_consent", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomerOverageConsent" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CommerceResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Otorisasi secara eksplisit kelebihan penggunaan dompet saat ini", "x-required-role": "owner" } }, "/api/v1/billing/overage-settings": { "get": { "description": "Hanya tenant saat ini. Anggota hanya baca dapat melihat. Jatah API tak terbatas tidak pernah dibatasi oleh preferensi kelebihan penggunaan pelanggan. Paket null berarti jatah default tidak tersedia.", "operationId": "get__api_v1_billing_overage_settings", "parameters": [], "responses": { "200": { "content": { "application/json": { "example": { "data": { "customer_api_settings_enabled": false, "customer_device_settings_enabled": false, "plan": null, "preference": { "block_api_overage": false, "block_device_overage": false, "mode": "sandbox", "updated_at": "2026-10-18T00:00:00Z", "version": "" } }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/OverageSettings", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "example": { "error": { "code": "DEFAULT_PLAN_DISABLED", "message": "The default allowance plan has not been enabled by the administrator" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Baca preferensi kelebihan penggunaan", "x-management-reference": { "group": "billing" }, "x-required-scope": "read" }, "patch": { "description": "Hanya sesi Owner. Setiap pilihan yang diberikan memerlukan izin administrator terkait; bidang yang tidak diizinkan menyebabkan seluruh permintaan ditolak dengan 403. Batas keras runtime = batas administrator OR preferensi pemblokiran pelanggan ketika izin tersebut diaktifkan. Tidak menghapus penggunaan atau biaya sebelumnya. Preferensi sandbox dan live bersifat independen.", "operationId": "patch__api_v1_billing_overage_settings", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OverageSettingsInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/OveragePreference" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Simpan preferensi kelebihan perangkat dan API secara independen" } }, "/api/v1/billing/paddle/orders": { "get": { "operationId": "get__api_v1_billing_paddle_orders", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PaddleOrderList" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Daftar pembayaran layanan Paddle dan isi ulang dompet", "x-licentivo-access": "session" }, "post": { "operationId": "post__api_v1_billing_paddle_orders", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaddleOrderInput" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PaddleOrderResult" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Buat atau pulihkan satu pembayaran layanan Paddle", "x-licentivo-access": "owner" } }, "/api/v1/billing/paddle/orders/{id}": { "get": { "operationId": "get__api_v1_billing_paddle_orders__id_", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PaddleOrderResult" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca transaksi checkout milik sendiri dan token klien publik", "x-licentivo-access": "session" } }, "/api/v1/billing/paddle/orders/{id}/reconcile": { "post": { "operationId": "post__api_v1_billing_paddle_orders__id__reconcile", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaddleReconcileInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PaddleOrderResult" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Verifikasi pembayaran dan penuhi layanan yang dibeli satu kali", "x-licentivo-access": "owner" } }, "/api/v1/billing/paypal/orders": { "get": { "operationId": "get_api_v1_billing_paypal_orders", "parameters": [ { "in": "query", "name": "limit", "schema": { "default": 25, "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "maximum": 100000, "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "amount_cents": 0, "approval_url": "", "capture_id": null, "created_at": "2026-10-18T00:00:00Z", "credited_at": null, "currency": "USD", "id": "33333333-3333-4333-8333-333333333333", "mode": "sandbox", "paypal_order_id": null, "purchase_id": null, "refunded_cents": 0, "request_id": "55555555-5555-4555-8555-555555555555", "status": "creating", "upgrade_id": null } ], "limit": 25, "offset": 0, "total": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PayPalOrderList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar pesanan isi ulang", "x-management-reference": { "group": "billing" }, "x-required-scope": "read" }, "post": { "description": " Ketentuan yang diterbitkan memerlukan policy_version dan persetujuan eksplisit di kedua lingkungan pembayaran. Kelebihan penggunaan layanan berbayar juga memerlukan overage_accepted. Sebelum publikasi kebijakan pertama, persetujuan draf tidak dicatat dan setiap operasi tetap mengikuti pemeriksaan pendaftaran, harga, dan pembayaran normalnya.", "operationId": "post_api_v1_billing_paypal_orders", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RechargeInput" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PayPalOrder" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "Buat/pulihkan isi ulang idempoten", "x-required-role": "owner" } }, "/api/v1/billing/paypal/orders/{id}/capture": { "post": { "operationId": "post_api_v1_billing_paypal_orders_by_id_capture", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } }, { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PayPalOrder" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "Konfirmasikan dana yang terikat pada pedagang satu kali", "x-required-role": "owner" } }, "/api/v1/billing/paypal/orders/{id}/reconcile": { "post": { "operationId": "post_api_v1_billing_paypal_orders_by_id_reconcile", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } }, { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PayPalOrder" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "Konfirmasikan dana yang terikat pada pedagang satu kali", "x-required-role": "owner" } }, "/api/v1/billing/paypal/orders/{id}/refund-requests": { "post": { "description": "Hanya sesi cookie; kunci API manajemen tidak diterima. Pembacaan pelanggan dibatasi ke ruang kerjanya. Penulisan pelanggan memerlukan Owner ruang kerja terverifikasi, tanpa izin administrator platform. Permohonan tidak memindahkan atau mencadangkan dana. Persetujuan administrator memeriksa ulang dompet saat ini dan nilai capture yang belum dikembalikan, lalu menggunakan alur pengembalian jalur asli dan reservasi idempoten yang ada. Persetujuan tidak membatalkan paket.", "operationId": "post__api_v1_billing_paypal_orders__id__refund_requests", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WalletRefundRequestInput" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WalletRefundRequest" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" } }, "security": [ { "session": [] } ], "summary": "Ajukan pengembalian kredit isi ulang saya yang belum dibelanjakan", "x-required-role": "owner" } }, "/api/v1/billing/plans": { "get": { "operationId": "get_api_v1_billing_plans", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PlanList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "Katalog harga publik yang dikelola administrator" } }, "/api/v1/billing/purchases": { "get": { "operationId": "get_api_v1_billing_purchases", "parameters": [ { "in": "query", "name": "limit", "schema": { "default": 25, "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "maximum": 100000, "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "active": null, "active_devices": 0, "coverage_ends_at": null, "items": [ { "api_calls": 0, "api_hard_limit": false, "api_overage_cents": 0, "api_unit_micros": 0, "base_cents": 0, "cancelled_at": null, "created_at": "2026-10-18T00:00:00Z", "currency": "USD", "current_cycle_index": 0, "current_upgrade_id": "", "cycle_ends_at": "2026-10-18T00:00:00Z", "cycle_starts_at": "2026-10-18T00:00:00Z", "effective_included_devices": 0, "effective_plan": "", "effective_plan_name": "", "ends_at": null, "entitlement_cents": 0, "gift_batch_id": "", "gift_follows_current": false, "hard_limit": false, "id": "33333333-3333-4333-8333-333333333333", "included_api_calls": null, "included_devices": 0, "mode": "sandbox", "overage_cents": 0, "plan": "starter", "plan_name": "Starter", "price_version": "example-v1", "refunded_cents": 0, "renewal": false, "renewal_of": "", "request_id": "55555555-5555-4555-8555-555555555555", "service_credit_basis_cents": 0, "service_credit_basis_seconds": 0, "source": "purchase", "starts_at": null, "status": "pending", "term_months": 1, "total_api_calls": 0, "total_api_overage_cents": 0, "total_device_overage_cents": 0, "unit_micros": 0 } ], "mode": "sandbox", "renewal_package": null, "total": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PurchaseList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar pembelian paket", "x-management-reference": { "group": "billing" }, "x-required-scope": "read" }, "post": { "description": "Buat pembelian dengan paket, mata uang, revisi harga, dan jangka waktu yang dipilih. Mencoba penyelesaian segera melalui dompet; saldo tidak cukup mengembalikan pending tanpa memulai cakupan. Tetapkan renewal=true untuk memperpanjang paket aktif. Pembayaran berhasil menjadwalkan layanan setelah cakupan yang ada; GET /billing/purchases melaporkan coverage_ends_at. Penggunaan kuota saat ini dan kedaluwarsa lisensi perangkat lunak tetap tidak berubah. Percobaan ulang menggunakan request_id yang sama dan tidak dapat menagih dua kali. Ketentuan yang diterbitkan memerlukan policy_version dan persetujuan eksplisit di kedua lingkungan pembayaran. Kelebihan penggunaan layanan berbayar juga memerlukan overage_accepted. Sebelum publikasi kebijakan pertama, persetujuan draf tidak dicatat dan setiap operasi tetap mengikuti pemeriksaan pendaftaran, harga, dan pembayaran normalnya.", "operationId": "post_api_v1_billing_purchases", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BuyPlan" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PlanPurchase" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "Beli paket atau bayar perpanjangan di muka", "x-required-role": "owner" } }, "/api/v1/billing/refund-requests": { "get": { "description": "Hanya sesi cookie; kunci API manajemen tidak diterima. Pembacaan pelanggan dibatasi ke ruang kerjanya. Penulisan pelanggan memerlukan Owner ruang kerja terverifikasi, tanpa izin administrator platform. Permohonan tidak memindahkan atau mencadangkan dana. Persetujuan administrator memeriksa ulang dompet saat ini dan nilai capture yang belum dikembalikan, lalu menggunakan alur pengembalian jalur asli dan reservasi idempoten yang ada. Persetujuan tidak membatalkan paket.", "operationId": "get__api_v1_billing_refund_requests", "parameters": [ { "in": "query", "name": "mode", "schema": { "enum": [ "sandbox", "live" ], "type": "string" } }, { "in": "query", "name": "limit", "schema": { "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WalletRefundRequestList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" } }, "security": [ { "session": [] } ], "summary": "Daftar permohonan pengembalian dana ruang kerja saya" } }, "/api/v1/billing/refund-requests/{id}/cancel": { "post": { "description": "Hanya sesi cookie; kunci API manajemen tidak diterima. Pembacaan pelanggan dibatasi ke ruang kerjanya. Penulisan pelanggan memerlukan Owner ruang kerja terverifikasi, tanpa izin administrator platform. Permohonan tidak memindahkan atau mencadangkan dana. Persetujuan administrator memeriksa ulang dompet saat ini dan nilai capture yang belum dikembalikan, lalu menggunakan alur pengembalian jalur asli dan reservasi idempoten yang ada. Persetujuan tidak membatalkan paket.", "operationId": "post__api_v1_billing_refund_requests__id__cancel", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WalletRefundRequest" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" } }, "security": [ { "session": [] } ], "summary": "Tarik permohonan pengembalian dana saya yang tertunda", "x-required-role": "owner" } }, "/api/v1/billing/renewal-plans": { "get": { "description": "Hanya kepemilikan dari pembelian selesai dan peningkatan yang diterapkan. Mengembalikan penawaran diterbitkan yang aktif dan penawaran tersembunyi khusus perpanjangan untuk pelanggan yang sudah memilikinya. Penawaran tertunda tidak menetapkan kepemilikan. Perpanjang menggunakan POST /billing/purchases sebelum atau setelah kedaluwarsa.", "operationId": "get__api_v1_billing_renewal_plans", "parameters": [], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "api_hard_limit": false, "api_unit_micros": 0, "base_micros": 0, "currency": "USD", "description": "Desktop reporting software", "enabled": true, "hard_limit": false, "included_api_calls": null, "included_devices": 0, "name": "Report app", "plan": "starter", "price_version": "example-v1", "public": false, "renewal_only": false, "sort_order": 0, "terms": [], "unit_micros": 0, "updated_at": "2026-10-18T00:00:00Z" } ], "mode": "sandbox" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/RenewalPlans", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "example": { "error": { "code": "DEFAULT_PLAN_DISABLED", "message": "The default allowance plan has not been enabled by the administrator" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar penawaran perpanjangan", "x-management-reference": { "group": "billing" }, "x-required-scope": "read" } }, "/api/v1/billing/subscription": { "get": { "operationId": "get_api_v1_billing_subscription", "parameters": [], "responses": { "200": { "content": { "application/json": { "example": { "data": { "current": { "base_covered": false, "base_micros": 0, "created_at": "2026-10-18T00:00:00Z", "currency": "USD", "hard_limit": false, "included_devices": 0, "month": "2026-09", "payment_mode": "sandbox", "plan": "starter", "plan_name": "Starter", "price_version": "example-v1", "unit_micros": 0 }, "next": null, "sandbox": false }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Subscription", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "503": { "content": { "application/json": { "example": { "error": { "code": "DEFAULT_PLAN_DISABLED", "message": "The default allowance plan has not been enabled by the administrator" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Jatah default dinonaktifkan (DEFAULT_PLAN_DISABLED)" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Baca langganan bulanan", "x-management-reference": { "group": "billing" }, "x-required-scope": "read" }, "patch": { "operationId": "patch_api_v1_billing_subscription", "parameters": [], "requestBody": { "content": { "application/json": { "example": { "currency": "USD", "plan": "starter", "price_version": "example-v1" }, "schema": { "$ref": "#/components/schemas/PlanChange" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "currency": "USD", "effective_month": "2026-11", "plan": "starter", "sandbox": false }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ScheduledPlan", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Jadwalkan paket bulanan", "x-management-reference": { "group": "billing" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/billing/upgrades": { "get": { "description": "", "operationId": "get__api_v1_billing_upgrades", "parameters": [ { "in": "query", "name": "limit", "schema": { "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "maximum": 100000, "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "amount_cents": 0, "api_hard_limit": false, "api_unit_micros": 0, "applied_at": null, "base_cents": 0, "created_at": "2026-10-18T00:00:00Z", "currency": "USD", "cycle_seconds": 0, "ends_at": "2026-10-18T00:00:00Z", "expires_at": "2026-10-18T00:00:00Z", "hard_limit": false, "id": "33333333-3333-4333-8333-333333333333", "included_api_calls": null, "included_devices": 0, "mode": "sandbox", "parent_id": "33333333-3333-4333-8333-333333333333", "parts": [], "plan": "starter", "plan_name": "Starter", "previous_base_cents": 0, "previous_plan_name": "", "previous_upgrade_id": "", "price_version": "example-v1", "purchase_id": "33333333-3333-4333-8333-333333333333", "remaining_seconds": 0, "request_id": "55555555-5555-4555-8555-555555555555", "status": "pending", "unit_micros": 0 } ], "total": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/UpgradeList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "422": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "502": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "503": { "content": { "application/json": { "example": { "error": { "code": "DEFAULT_PLAN_DISABLED", "message": "The default allowance plan has not been enabled by the administrator" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar peningkatan paket", "x-management-reference": { "group": "billing" }, "x-required-scope": "read" } }, "/api/v1/billing/upgrades/quote": { "post": { "description": "Memerlukan sesi Owner. Target harus menggunakan mata uang yang sama, tanpa harga bulanan atau jatah perangkat/API yang lebih rendah. Mempertahankan kedaluwarsa dan penggunaan asli. Peningkatan selalu mencakup seluruh cakupan prabayar/hadiah saat ini dan masa depan. Setiap periode mengkredit nilai manfaat aslinya secara proporsional menurut detik yang tersisa; periode yang belum dimulai menggunakan seluruh durasinya. Nilai hadiah bukan uang tunai yang dapat dikembalikan. Pembayaran berupa satu debit dompet atomik; tanggal dan kuota yang telah digunakan tetap ada. Perpanjangan, hadiah, atau pembatalan antara penawaran dan pembayaran membatalkan penawaran dengan UPGRADE_STATE_CONFLICT; isi ulang PayPal tertaut yang terlambat tetap menjadi kredit dompet. Cakupan yang berubah memerlukan penawaran baru.", "operationId": "post__api_v1_billing_upgrades_quote", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpgradeQuoteInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PlanUpgrade" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." } }, "security": [ { "session": [] } ], "summary": "Pratinjau peningkatan paket secara proporsional tanpa mendebit dompet" } }, "/api/v1/billing/upgrades/{id}/pay": { "post": { "description": "Mengembalikan pending tanpa mengubah paket ketika saldo tidak cukup. Mengembalikan applied setelah menagih satu kali. Paket aktif yang berubah atau penawaran kedaluwarsa mengembalikan 409. Peningkatan selalu mencakup seluruh cakupan prabayar/hadiah saat ini dan masa depan. Setiap periode mengkredit nilai manfaat aslinya secara proporsional menurut detik yang tersisa; periode yang belum dimulai menggunakan seluruh durasinya. Nilai hadiah bukan uang tunai yang dapat dikembalikan. Pembayaran berupa satu debit dompet atomik; tanggal dan kuota yang telah digunakan tetap ada. Perpanjangan, hadiah, atau pembatalan antara penawaran dan pembayaran membatalkan penawaran dengan UPGRADE_STATE_CONFLICT; isi ulang PayPal tertaut yang terlambat tetap menjadi kredit dompet. Cakupan yang berubah memerlukan penawaran baru. Persetujuan eksplisit terhadap kebijakan saat ini diperlukan sebelum pembayaran baru. Replay yang sudah dibayar mempertahankan tanda terima aslinya.", "operationId": "post__api_v1_billing_upgrades__id__pay", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LegalConsent" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PlanUpgrade" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." } }, "security": [ { "session": [] } ], "summary": "Konfirmasi dan bayar penawaran peningkatan yang valid satu kali" } }, "/api/v1/billing/waffo/orders": { "get": { "operationId": "get__api_v1_billing_waffo_orders", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WaffoOrderList" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Daftar pembayaran layanan Waffo dan isi ulang dompet", "x-licentivo-access": "session" }, "post": { "operationId": "post__api_v1_billing_waffo_orders", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WaffoOrderInput" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WaffoOrderResult" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Buat atau pulihkan satu pembayaran layanan Waffo", "x-licentivo-access": "owner" } }, "/api/v1/billing/waffo/orders/{id}": { "get": { "operationId": "get__api_v1_billing_waffo_orders__id_", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WaffoOrderResult" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca checkout Waffo ruang kerja sendiri", "x-licentivo-access": "session" } }, "/api/v1/billing/waffo/orders/{id}/reconcile": { "post": { "operationId": "post__api_v1_billing_waffo_orders__id__reconcile", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WaffoOrderResult" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Verifikasi pembayaran dan rekonsiliasi layanan serta pengembalian dana", "x-licentivo-access": "owner" } }, "/api/v1/billing/wallet": { "get": { "operationId": "get_api_v1_billing_wallet", "parameters": [], "responses": { "200": { "content": { "application/json": { "example": { "data": { "currencies": [], "items": [ { "balance_cents": 0, "currency": "USD", "mode": "sandbox" } ], "maximum_cents": 0, "minimum_cents": 0, "mode": "sandbox", "payment_channels": [], "paypal_enabled": false }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WalletResult", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Baca saldo dompet", "x-management-reference": { "group": "billing" }, "x-required-scope": "read" } }, "/api/v1/billing/wallet/entries": { "get": { "operationId": "get_api_v1_billing_wallet_entries", "parameters": [ { "in": "query", "name": "limit", "schema": { "default": 25, "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "maximum": 100000, "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "amount_cents": 0, "balance_cents": 0, "created_at": "2026-10-18T00:00:00Z", "currency": "USD", "id": "33333333-3333-4333-8333-333333333333", "kind": "", "mode": "sandbox", "reference": "" } ], "limit": 25, "offset": 0, "total": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WalletEntryList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar entri dompet", "x-management-reference": { "group": "billing" }, "x-required-scope": "read" } }, "/api/v1/consume": { "post": { "description": "Operasi runtime yang diautentikasi lisensi; tanpa cookie vendor atau API Key. Konsumsi fitur memerlukan Idempotency-Key yang stabil; consume tidak mendebit API platform.", "operationId": "post_api_v1_consume", "parameters": [ { "description": "Buat kunci baru untuk setiap operasi; percobaan ulang mempertahankan kunci dan isi yang sama. Maksimum 80 karakter, tanpa spasi. Opsional untuk validasi dan heartbeat.", "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 80, "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RuntimeInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ConsumptionResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "/consume" } }, "/api/v1/consume/cancel": { "post": { "description": "Reservasi sebelum tindakan bisnis; commit hanya setelah berhasil; cancel jika gagal. Pertahankan pengenal job dan isi permintaan yang sama selama percobaan ulang. Commit yang timeout tidak pasti: coba ulang commit, jangan pernah cancel atau mengulangi pekerjaan yang telah selesai. Reservasi selesai mengembalikan status saat ini; tidak ada debit API platform. Penyelesaian memancarkan license.consume; penahanan sementara tidak memancarkan peristiwa konsumsi.", "operationId": "post_api_v1_consume_cancel", "parameters": [ { "description": "Buat kunci baru untuk setiap operasi; percobaan ulang mempertahankan kunci dan isi yang sama. Maksimum 80 karakter, tanpa spasi. Opsional untuk validasi dan heartbeat.", "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 80, "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RuntimeInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ReservationResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "Unit fitur: cancel" } }, "/api/v1/consume/commit": { "post": { "description": "Reservasi sebelum tindakan bisnis; commit hanya setelah berhasil; cancel jika gagal. Pertahankan pengenal job dan isi permintaan yang sama selama percobaan ulang. Commit yang timeout tidak pasti: coba ulang commit, jangan pernah cancel atau mengulangi pekerjaan yang telah selesai. Reservasi selesai mengembalikan status saat ini; tidak ada debit API platform. Penyelesaian memancarkan license.consume; penahanan sementara tidak memancarkan peristiwa konsumsi.", "operationId": "post_api_v1_consume_commit", "parameters": [ { "description": "Buat kunci baru untuk setiap operasi; percobaan ulang mempertahankan kunci dan isi yang sama. Maksimum 80 karakter, tanpa spasi. Opsional untuk validasi dan heartbeat.", "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 80, "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RuntimeInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ReservationResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "Unit fitur: commit" } }, "/api/v1/consume/reserve": { "post": { "description": "Reservasi sebelum tindakan bisnis; commit hanya setelah berhasil; cancel jika gagal. Pertahankan pengenal job dan isi permintaan yang sama selama percobaan ulang. Commit yang timeout tidak pasti: coba ulang commit, jangan pernah cancel atau mengulangi pekerjaan yang telah selesai. Reservasi selesai mengembalikan status saat ini; tidak ada debit API platform. Penyelesaian memancarkan license.consume; penahanan sementara tidak memancarkan peristiwa konsumsi.", "operationId": "post_api_v1_consume_reserve", "parameters": [ { "description": "Buat kunci baru untuk setiap operasi; percobaan ulang mempertahankan kunci dan isi yang sama. Maksimum 80 karakter, tanpa spasi. Opsional untuk validasi dan heartbeat.", "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 80, "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RuntimeInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ReservationResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "Unit fitur: reservasi" } }, "/api/v1/customer/activations/{id}/release": { "post": { "operationId": "post_api_v1_customer_activations_by_id_release", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } }, { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomerReleaseInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CustomerReleaseResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "customerSession": [] } ], "summary": "/customer/activations/{id}/release" } }, "/api/v1/customer/cases": { "get": { "description": "", "operationId": "get__api_v1_customer_cases", "parameters": [ { "description": "Kecualikan satu jenis permintaan sebelum penghitungan dan paginasi. Gunakan refund untuk mengeluarkan kasus pengembalian dana dari daftar dukungan; akses tetap terbatas pada sesi saat ini.", "in": "query", "name": "exclude_kind", "schema": { "maxLength": 24, "type": "string" } }, { "description": "Batasi kasus pengembalian dana ke isi ulang dompet atau pembatalan layanan.", "in": "query", "name": "refund_scope", "required": false, "schema": { "enum": [ "wallet", "service" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportCaseList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Daftar permintaan pelanggan", "x-required-role": "session" }, "post": { "description": "request_id yang stabil dicakup ke ruang kerja; konten yang berubah tidak dapat menggunakannya kembali.", "operationId": "post__api_v1_customer_cases", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportCaseInput" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportCase" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Buat permintaan dukungan, privasi, atau banding", "x-required-role": "session" } }, "/api/v1/customer/cases/unread": { "get": { "description": "Percakapan pengembalian dana dikecualikan. Pelanggan hanya melihat tiket ruang kerja yang diotorisasi; anggota melihat tiketnya sendiri. Setiap administrator memiliki penanda baca independen.", "operationId": "get__api_v1_customer_cases_unread", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportUnread" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca jumlah tiket pribadi dan pemberitahuan yang belum dibaca", "x-required-role": "session" } }, "/api/v1/customer/cases/{id}": { "get": { "description": "", "operationId": "get__api_v1_customer_cases__id_", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportCaseDetail" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca permintaan dan balasan", "x-required-role": "session" } }, "/api/v1/customer/cases/{id}/messages": { "post": { "description": "Kasus pengembalian dana menolak balasan dengan REFUND_REVIEW_WORKFLOW; administrator menyetujui atau menolak secara langsung. Tiket dukungan biasa tetap menerima balasan. Penutupan yang ditinjau mempertahankan status alur privasinya.", "operationId": "post__api_v1_customer_cases__id__messages", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportReply" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportCaseDetail" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Balas tiket dukungan", "x-required-role": "session" } }, "/api/v1/customer/cases/{id}/read": { "post": { "description": "Hanya pesan hingga pesan terakhir yang ditampilkan yang ditandai telah dibaca. Pesan yang datang kemudian tetap belum dibaca dan pengakuan tertunda tidak dapat menggeser penanda ke belakang.", "operationId": "post__api_v1_customer_cases__id__read", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportReadInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CommerceResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Akui pesan tiket yang ditampilkan", "x-required-role": "session" } }, "/api/v1/customer/compensations": { "get": { "description": "", "operationId": "get__api_v1_customer_compensations", "parameters": [], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "created_at": "2026-10-18T00:00:00Z", "id": "33333333-3333-4333-8333-333333333333", "incident_id": "33333333-3333-4333-8333-333333333333", "intervals": "", "mode": "timed", "purchase_id": "33333333-3333-4333-8333-333333333333", "seconds": 0 } ] }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ServiceCompensationList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar kompensasi layanan", "x-management-reference": { "group": "service" }, "x-required-role": "session", "x-required-scope": "read" } }, "/api/v1/customer/licenses": { "get": { "operationId": "get_api_v1_customer_licenses", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CustomerLicenses" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "customerSession": [] } ], "summary": "Lisensi pembeli yang terhubung" } }, "/api/v1/customer/login": { "post": { "operationId": "post_api_v1_customer_login", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Email" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Notice" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "/customer/login" } }, "/api/v1/customer/logout": { "post": { "operationId": "post_api_v1_customer_logout", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LoggedOut" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "customerSession": [] } ], "summary": "/customer/logout" } }, "/api/v1/customer/notices": { "get": { "description": "", "operationId": "get__api_v1_customer_notices", "parameters": [], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "body": "", "created_at": "2026-10-18T00:00:00Z", "effective_at": null, "emailed_at": null, "id": "33333333-3333-4333-8333-333333333333", "kind": "", "read_at": null, "reference": "", "title": "" } ] }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CommerceNoticeList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar pemberitahuan layanan", "x-management-reference": { "group": "service" }, "x-required-role": "session", "x-required-scope": "read" } }, "/api/v1/customer/notices/{id}/read": { "post": { "description": "", "operationId": "post__api_v1_customer_notices__id__read", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CommerceResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Tandai pemberitahuan sendiri sebagai dibaca", "x-required-role": "session" } }, "/api/v1/customer/offline/respond": { "post": { "operationId": "post_api_v1_customer_offline_respond", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OfflineRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/OfflineResponse" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "customerSession": [] } ], "summary": "/customer/offline/respond" } }, "/api/v1/customer/refunds": { "post": { "description": "Cakupan eksplisit memerlukan konfirmasi serta quote_hash dan quoted_at yang dikembalikan. Layanan tetap aktif sampai persetujuan administrator. Status yang berubah atau penawaran kedaluwarsa memerlukan pratinjau baru; permohonan tertunda yang bertentangan ditolak. Permintaan tanpa cakupan memungkinkan pembatalan segera yang memenuhi syarat setelah konfirmasi eksplisit. order_id juga dapat memilih pembayaran Waffo/Paddle paid_unapplied dengan reason=failed_delivery; ini tidak membekukan kredit dompet yang tidak pernah diberikan.", "operationId": "post__api_v1_customer_refunds", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomerRefundInput" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportCase" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Ajukan permohonan pengembalian dana untuk peninjauan langsung", "x-required-role": "owner" } }, "/api/v1/customer/refunds/quote": { "post": { "description": "Cakupan pembelian/layanan eksplisit mengembalikan hash snapshot terbatas, pembelian terdampak, estimasi pengembalian per mata uang, dan tanggal tersisa. Pengajuan tidak menghentikan layanan. Hadiah tidak memiliki nilai tunai; peningkatan berbayar tetap dapat dikembalikan melalui peninjauan.", "operationId": "post__api_v1_customer_refunds_quote", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomerRefundQuoteInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CustomerRefundQuote" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Pratinjau cakupan pembatalan, pengembalian dana, dan layanan tersisa", "x-required-role": "owner" } }, "/api/v1/customer/refunds/{id}/cancel": { "post": { "operationId": "post__api_v1_customer_refunds__id__cancel", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelCustomerRefund" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportCaseDetail" }, "request_id": { "format": "uuid", "type": "string" } }, "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" } }, "security": [ { "session": [] } ], "summary": "Tarik permintaan pengembalian dana saya yang tersisa dan belum ditinjau", "x-required-role": "owner" } }, "/api/v1/customer/verify": { "post": { "operationId": "post_api_v1_customer_verify", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Token" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CustomerSession" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "/customer/verify" } }, "/api/v1/deactivate": { "post": { "description": "Diautentikasi dengan product_id + license_key + device_id. Tanpa cookie/CSRF/kunci vendor. activation_id wajib kecuali untuk activate. Setiap permintaan berhasil mengonsumsi satu panggilan API; replay idempoten dan kegagalan tidak. Kelebihan penggunaan mendebit dompet secara atomik atau mengembalikan API_QUOTA_EXCEEDED/API_BALANCE_INSUFFICIENT. Kuota perangkat ruang kerja mengikuti aktivasi saat ini. Pelepasan mengembalikan kapasitas; kedaluwarsa lease floating juga mengembalikan kapasitas, sedangkan pendaftaran biasa yang offline tetap dihitung. Kelebihan perangkat hanya ditagih ketika puncak penagihan bulan kuota meningkat melampaui kapasitas yang sudah dibayar; pelepasan tidak mengembalikan biaya yang telah terjadi. Penggunaan API terpisah.", "operationId": "post_api_v1_deactivate", "parameters": [ { "description": "Buat kunci baru untuk setiap operasi; percobaan ulang mempertahankan kunci dan isi yang sama. Maksimum 80 karakter, tanpa spasi. Opsional untuk validasi dan heartbeat.", "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 80, "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RuntimeInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/RuntimeResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "Deaktivasi runtime" } }, "/api/v1/demo/trial": { "post": { "operationId": "post_api_v1_demo_trial", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Trial" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "Buat satu uji coba SDK tujuh hari yang terisolasi per owner", "x-required-role": "owner" } }, "/api/v1/examples/sdk": { "get": { "operationId": "get_api_v1_examples_sdk", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SDKExampleInfo" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "Ketersediaan contoh SDK publik" } }, "/api/v1/examples/sdk/download/{name}": { "get": { "operationId": "get_api_v1_examples_sdk_download_{name}", "parameters": [ { "in": "path", "name": "name", "required": true, "schema": { "description": "Bahasa ditambah .zip, misalnya csharp.zip", "type": "string" } } ], "responses": { "200": { "content": { "application/zip": { "schema": { "format": "binary", "type": "string" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "Unduh sumber dengan pengaturan produk publik yang sudah ada dalam kode" } }, "/api/v1/examples/sdk/trial": { "post": { "description": "Memerlukan CSRF browser dan cookie pengunjung HttpOnly. Setiap pengunjung mendapat lisensi terpisah; tiga hari dimulai pada aktivasi pertama. Klaim berulang tidak pernah memperpanjang kedaluwarsa. Mengaktifkan export, bukan pro.", "operationId": "post_api_v1_examples_sdk_trial", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SDKExampleTrial" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "Klaim/pulihkan uji coba tiga hari independen pengunjung ini" } }, "/api/v1/forum/images": { "post": { "operationId": "post__api_v1_forum_images", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "multipart/form-data": { "schema": { "additionalProperties": false, "properties": { "image": { "description": "PNG, JPEG, atau GIF; maksimal 5 MB, 4096 × 4096 dan 16 juta piksel. GIF disimpan sebagai PNG statis. Privat sampai dilampirkan ke posting yang diterbitkan.", "format": "binary", "type": "string" } }, "required": [ "image" ], "type": "object" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ForumImage" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" } }, "security": [ { "session": [] } ], "summary": "Unggah gambar draf privat", "tags": [ "Community" ] } }, "/api/v1/forum/replies/{id}": { "delete": { "operationId": "delete__api_v1_forum_replies__id_", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "type": "string" } }, "required": [ "id" ], "type": "object" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" } }, "security": [ { "session": [] } ], "summary": "Hapus balasan (penulis atau admin platform)", "tags": [ "Community" ] }, "patch": { "operationId": "patch__api_v1_forum_replies__id_", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForumReplyInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "type": "string" } }, "required": [ "id" ], "type": "object" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" } }, "security": [ { "session": [] } ], "summary": "Edit balasan sendiri", "tags": [ "Community" ] } }, "/api/v1/forum/topics": { "get": { "operationId": "get__api_v1_forum_topics", "parameters": [ { "in": "query", "name": "limit", "schema": { "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "maximum": 100000, "minimum": 0, "type": "integer" } }, { "in": "query", "name": "q", "schema": { "type": "string" } }, { "in": "query", "name": "category", "schema": { "type": "string" } }, { "in": "query", "name": "language", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ForumTopicList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" } }, "security": [], "summary": "Daftar diskusi publik, yang disematkan lebih dahulu", "tags": [ "Community" ] }, "post": { "operationId": "post__api_v1_forum_topics", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForumTopicInput" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "type": "string" } }, "required": [ "id" ], "type": "object" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" } }, "security": [ { "session": [] } ], "summary": "Buat diskusi (anggota tenant terverifikasi mana pun)", "tags": [ "Community" ] } }, "/api/v1/forum/topics/{id}": { "delete": { "operationId": "delete__api_v1_forum_topics__id_", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "type": "string" } }, "required": [ "id" ], "type": "object" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" } }, "security": [ { "session": [] } ], "summary": "Hapus diskusi (penulis atau admin platform)", "tags": [ "Community" ] }, "get": { "operationId": "get__api_v1_forum_topics__id_", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "query", "name": "limit", "schema": { "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "maximum": 100000, "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ForumTopicDetail" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" } }, "security": [], "summary": "Baca diskusi publik dan balasan", "tags": [ "Community" ] }, "patch": { "operationId": "patch__api_v1_forum_topics__id_", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForumTopicInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "type": "string" } }, "required": [ "id" ], "type": "object" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" } }, "security": [ { "session": [] } ], "summary": "Edit diskusi sendiri", "tags": [ "Community" ] } }, "/api/v1/forum/topics/{id}/moderation": { "post": { "operationId": "post__api_v1_forum_topics__id__moderation", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForumModerationInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "type": "string" } }, "required": [ "id" ], "type": "object" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" } }, "security": [ { "session": [] } ], "summary": "Sematkan, lepas sematan, sembunyikan, atau kunci diskusi (admin platform)", "tags": [ "Community" ] } }, "/api/v1/forum/topics/{id}/replies": { "post": { "operationId": "post__api_v1_forum_topics__id__replies", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForumReplyInput" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "type": "string" } }, "required": [ "id" ], "type": "object" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kode kesalahan dan ID permintaan; detail akun tidak diungkap" } }, "security": [ { "session": [] } ], "summary": "Balas diskusi", "tags": [ "Community" ] } }, "/api/v1/forum/topics/{id}/translate": { "post": { "description": "Pengunjung anonim dapat menggunakan endpoint ini dengan token CSRF. Hanya teks forum tersimpan yang telah diterbitkan yang diterima, bukan teks sembarang yang dikirim. Terjemahan di-cache menurut konten dan bahasa target. Topik/balasan tersembunyi mengembalikan 404; terjemahan bersamaan dapat mengembalikan TRANSLATION_PENDING. Teks asli dipertahankan.", "operationId": "post__api_v1_forum_topics__id__translate", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForumTranslationInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ForumTranslationResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." } }, "security": [], "summary": "Terjemahkan topik atau balasan yang diterbitkan" } }, "/api/v1/forum/translation": { "get": { "description": "", "operationId": "get__api_v1_forum_translation", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/TranslationOptions" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." } }, "security": [], "summary": "Dapatkan bahasa target terjemahan yang tersedia untuk publik" } }, "/api/v1/heartbeat": { "post": { "description": "Diautentikasi dengan product_id + license_key + device_id. Tanpa cookie/CSRF/kunci vendor. activation_id wajib kecuali untuk activate. Setiap permintaan berhasil mengonsumsi satu panggilan API; replay idempoten dan kegagalan tidak. Kelebihan penggunaan mendebit dompet secara atomik atau mengembalikan API_QUOTA_EXCEEDED/API_BALANCE_INSUFFICIENT. Tanda terima percobaan ulang validasi dan heartbeat kedaluwarsa setelah 3600 detik. Selama otorisasi asli tetap valid, permintaan yang cocok dalam rentang ini diputar ulang tanpa debit tambahan. Setelah rentang tersebut gunakan kunci baru; kunci yang pernah digunakan dapat diproses sebagai permintaan baru. Tanda terima aktivasi, deaktivasi, dan penggunaan fitur tetap persisten. Kuota perangkat ruang kerja mengikuti aktivasi saat ini. Pelepasan mengembalikan kapasitas; kedaluwarsa lease floating juga mengembalikan kapasitas, sedangkan pendaftaran biasa yang offline tetap dihitung. Kelebihan perangkat hanya ditagih ketika puncak penagihan bulan kuota meningkat melampaui kapasitas yang sudah dibayar; pelepasan tidak mengembalikan biaya yang telah terjadi. Penggunaan API terpisah.", "operationId": "post_api_v1_heartbeat", "parameters": [ { "description": "Buat kunci baru untuk setiap operasi; percobaan ulang mempertahankan kunci dan isi yang sama. Maksimum 80 karakter, tanpa spasi. Opsional untuk validasi dan heartbeat.", "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "maxLength": 80, "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RuntimeInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/RuntimeResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "Heartbeat runtime" } }, "/api/v1/launch/connections": { "get": { "description": "Daftar koneksi kepercayaan Launch. Keputusan, percobaan ulang, dan pemeriksaan cakupan dilakukan oleh Licentivo.", "operationId": "launch_get__api_v1_launch_connections", "parameters": [], "responses": { "200": { "content": { "application/json": { "example": { "data": {}, "request_id": "request_id_example" }, "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "description": "Hasil operasi ini.", "properties": { "items": { "description": "Catatan yang cocok dalam cakupan yang diminta.", "items": { "$ref": "#/components/schemas/LaunchConnection" }, "type": "array" } }, "required": [], "type": "object" }, "request_id": { "description": "Pengenal korelasi permintaan HTTP.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Hasil yang diterima" }, "400": { "description": "Input tidak valid" }, "401": { "description": "Autentikasi atau assertion identitas ditolak" }, "403": { "description": "Hak, kredensial, lingkungan, atau login dicabut" }, "409": { "description": "Konflik versi idempotensi, kebijakan, peninjauan, atau pengikatan" }, "503": { "description": "Kegagalan sementara; coba ulang operasi asli" } }, "security": [ { "managementKey": [] }, { "session": [] } ], "summary": "Daftar koneksi kepercayaan Launch", "tags": [ "Launch account licensing" ], "x-management-reference": { "group": "integration" }, "x-required-scope": "read" }, "post": { "description": "Daftarkan issuer Launch dan lingkungan perdagangan. Keputusan, percobaan ulang, dan pemeriksaan cakupan dilakukan oleh Licentivo.", "operationId": "launch_post__api_v1_launch_connections", "parameters": [], "requestBody": { "content": { "application/json": { "example": { "audience": "licentivo:launch", "enabled": true, "environment": "live", "issuer": "https://shop.example.test", "public_keys": { "launch-1": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" } }, "schema": { "$ref": "#/components/schemas/LaunchConnectionInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "audience": "licentivo:launch", "enabled": true, "environment": "live", "id": "11111111-1111-4111-8111-111111111111", "issuer": "https://shop.example.test" }, "request_id": "request_id_example" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LaunchConnection", "description": "Hasil operasi ini." }, "request_id": { "description": "Pengenal korelasi permintaan HTTP.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Hasil yang diterima" }, "400": { "description": "Input tidak valid" }, "401": { "description": "Autentikasi atau assertion identitas ditolak" }, "403": { "description": "Hak, kredensial, lingkungan, atau login dicabut" }, "409": { "description": "Konflik versi idempotensi, kebijakan, peninjauan, atau pengikatan" }, "503": { "description": "Kegagalan sementara; coba ulang operasi asli" } }, "security": [ { "managementKey": [] }, { "session": [] } ], "summary": "Daftarkan issuer Launch dan lingkungan perdagangan", "tags": [ "Launch account licensing" ], "x-management-reference": { "group": "integration" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/launch/connections/{id}": { "put": { "description": "Issuer, audience, dan lingkungan tidak dapat diubah. Berikan set lengkap kunci publik tepercaya.", "operationId": "launch_put__api_v1_launch_connections_id_", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "audience": "licentivo:launch", "enabled": true, "environment": "live", "issuer": "https://shop.example.test", "public_keys": { "launch-1": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" } }, "schema": { "$ref": "#/components/schemas/LaunchConnectionInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "audience": "licentivo:launch", "enabled": true, "environment": "live", "id": "11111111-1111-4111-8111-111111111111", "issuer": "https://shop.example.test" }, "request_id": "request_id_example" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LaunchConnection", "description": "Hasil operasi ini." }, "request_id": { "description": "Pengenal korelasi permintaan HTTP.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Hasil yang diterima" }, "400": { "description": "Input tidak valid" }, "401": { "description": "Autentikasi atau assertion identitas ditolak" }, "403": { "description": "Hak, kredensial, lingkungan, atau login dicabut" }, "409": { "description": "Konflik versi idempotensi, kebijakan, peninjauan, atau pengikatan" }, "503": { "description": "Kegagalan sementara; coba ulang operasi asli" } }, "security": [ { "managementKey": [] }, { "session": [] } ], "summary": "Rotasi kunci Launch atau perbarui batas runtime", "tags": [ "Launch account licensing" ], "x-management-reference": { "group": "integration" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/launch/connections/{id}/devices/{activation}/release": { "post": { "description": "Licentivo mencadangkan jatah pelepasan mandiri 30 hari, mencatat operasi, dan mengelola percobaan ulang serta pemeriksaan manual. Worker membandingkan versi pengikatan dan mencabut sesi serta kredensial dalam kunci transaksi yang sama. Sesi login Launch lama tidak dapat menukar assertion identitas lain pada perangkat yang dicabut.", "operationId": "launch_post__api_v1_launch_connections_id_devices_activation_release", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } }, { "in": "path", "name": "activation", "required": true, "schema": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "account_ref": "account_ref_example", "entitlement_ref": "entitlement_ref_example", "environment": "live", "expected_generation": 1, "operation_id": "11111111-1111-4111-8111-111111111111" }, "schema": { "$ref": "#/components/schemas/LaunchDeviceReleaseInput" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "example": { "data": { "activation_id": "11111111-1111-4111-8111-111111111111", "expected_generation": 1, "license_id": "11111111-1111-4111-8111-111111111111", "operation_id": "11111111-1111-4111-8111-111111111111", "source": "logout", "status": "pending" }, "request_id": "request_id_example" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/DeviceReleaseOperation", "description": "Hasil operasi ini." }, "request_id": { "description": "Pengenal korelasi permintaan HTTP.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Hasil yang diterima" }, "400": { "description": "Input tidak valid" }, "401": { "description": "Autentikasi atau assertion identitas ditolak" }, "403": { "description": "Hak, kredensial, lingkungan, atau login dicabut" }, "409": { "description": "Konflik versi idempotensi, kebijakan, peninjauan, atau pengikatan" }, "503": { "description": "Kegagalan sementara; coba ulang operasi asli" } }, "security": [ { "managementKey": [] }, { "session": [] } ], "summary": "Minta pelepasan jarak jauh perangkat akun yang berversi", "tags": [ "Launch account licensing" ], "x-management-reference": { "group": "integration" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/launch/connections/{id}/entitlements/{entitlement}/devices": { "get": { "description": "Baca perangkat akun, jatah pelepasan otoritatif, dan operasi. Keputusan, percobaan ulang, dan pemeriksaan cakupan dilakukan oleh Licentivo.", "operationId": "launch_get__api_v1_launch_connections_id_entitlements_entitlement_devices", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } }, { "in": "path", "name": "entitlement", "required": true, "schema": { "description": "Referensi hak pembelian yang tidak dapat diubah dan peka huruf besar/kecil.", "pattern": "^[A-Za-z0-9_-]{1,128}$", "type": "string" } }, { "in": "query", "name": "account_ref", "required": true, "schema": { "description": "Referensi hak pembelian yang tidak dapat diubah dan peka huruf besar/kecil.", "pattern": "^[A-Za-z0-9_-]{1,128}$", "type": "string" } }, { "in": "query", "name": "environment", "required": true, "schema": { "description": "Lingkungan perdagangan, dipatok pada koneksi dan grant bertanda tangan.", "enum": [ "live", "sandbox" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": {}, "request_id": "request_id_example" }, "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "description": "Hasil operasi ini.", "properties": { "can_release": { "description": "Apakah koneksi kepercayaan ini dapat mengotorisasi penggunaan runtime baru.", "type": "boolean" }, "items": { "description": "Catatan yang cocok dalam cakupan yang diminta.", "items": { "additionalProperties": false, "properties": { "device_name": { "description": "Label perangkat yang dapat dibaca manusia.", "type": "string" }, "generation": { "description": "Inkarnasi pengikatan perangkat saat ini.", "type": "integer" }, "id": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" }, "last_seen_at": { "description": "Waktu pembuatan catatan dalam UTC.", "format": "date-time", "type": "string" }, "status": { "description": "Siklus hidup atau status pemrosesan saat ini yang dimiliki server.", "type": "string" } }, "required": [], "type": "object" }, "type": "array" }, "operations": { "description": "Riwayat operasi pelepasan perangkat milik server.", "items": { "$ref": "#/components/schemas/DeviceReleaseOperation" }, "type": "array" }, "remaining": { "description": "Sisa pelepasan mandiri dalam 30 hari terakhir, dihitung oleh Licentivo.", "type": "integer" } }, "required": [], "type": "object" }, "request_id": { "description": "Pengenal korelasi permintaan HTTP.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Hasil yang diterima" }, "400": { "description": "Input tidak valid" }, "401": { "description": "Autentikasi atau assertion identitas ditolak" }, "403": { "description": "Hak, kredensial, lingkungan, atau login dicabut" }, "409": { "description": "Konflik versi idempotensi, kebijakan, peninjauan, atau pengikatan" }, "503": { "description": "Kegagalan sementara; coba ulang operasi asli" } }, "security": [ { "managementKey": [] }, { "session": [] } ], "summary": "Baca perangkat akun, jatah pelepasan otoritatif, dan operasi", "tags": [ "Launch account licensing" ], "x-management-reference": { "group": "integration" }, "x-required-scope": "read" } }, "/api/v1/launch/connections/{id}/events": { "post": { "description": "Simpan secara persisten sebelum mengakui penerimaan. ID duplikat dengan isi berbeda menyebabkan konflik. Worker menerapkan masa berlaku absolut dan versi agregat yang meningkat secara monoton dalam transaksi, mengabaikan versi lama, dan mencoba ulang kegagalan hingga 12 percobaan sebelum pemeriksaan manual. Untuk hak yang sudah ada, pengembalian dana, penangguhan, dan kedaluwarsa mencabut akses secara independen dari pemetaan paket, versi kebijakan, mode masa berlaku, dan hunian perangkat, sambil mempertahankan pemeriksaan kepemilikan dan versi. Penurunan paket menerapkan fitur baru, aturan meter, dan batas perangkat efektif secara bersama, mempertahankan pengikatan terlama, serta mencabut sesi dan kredensial perangkat berlebih tanpa mengonsumsi jatah pelepasan mandiri. Perpanjangan, perubahan paket, dan penyimpanan kebijakan mempertahankan batas fitur dan perangkat manual yang independen. Snapshot entitlement.downgraded eksplisit mempertahankan status komersial aktif tetapi memblokir hak lama secara persisten jika penerapan gagal. Snapshot aktif yang ada dengan pengurangan yang dapat dibuktikan mendapat perlindungan yang sama. Hanya snapshot yang diterapkan pada atau di atas versi pembatasan tertunda yang menghapus penghalang tersebut. Percobaan ulang runtime idempoten mempertahankan deduplikasi operasi sambil memperbarui tenggat otorisasi dan pembelian yang berubah. Periksa peristiwa sebelum menyatakan lisensi siap.", "operationId": "launch_post__api_v1_launch_connections_id_events", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "account_ref": "account_ref_example", "entitlement_ref": "entitlement_ref_example", "environment": "live", "event_id": "11111111-1111-4111-8111-111111111111", "launch_product_id": "11111111-1111-4111-8111-111111111111", "plan_ref": "plan_ref_example", "type": "entitlement.created", "valid_from": "2026-10-24T00:00:00Z", "version": 1 }, "schema": { "$ref": "#/components/schemas/LaunchCommerceEvent" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "example": { "data": { "attempts": 1, "available_at": "2026-10-24T00:00:00Z", "connection_id": "11111111-1111-4111-8111-111111111111", "event_id": "11111111-1111-4111-8111-111111111111", "status": "pending" }, "request_id": "request_id_example" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LaunchEvent", "description": "Hasil operasi ini." }, "request_id": { "description": "Pengenal korelasi permintaan HTTP.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Hasil yang diterima" }, "400": { "description": "Input tidak valid" }, "401": { "description": "Autentikasi atau assertion identitas ditolak" }, "403": { "description": "Hak, kredensial, lingkungan, atau login dicabut" }, "409": { "description": "Konflik versi idempotensi, kebijakan, peninjauan, atau pengikatan" }, "503": { "description": "Kegagalan sementara; coba ulang operasi asli" } }, "security": [ { "managementKey": [] }, { "session": [] } ], "summary": "Terima snapshot perdagangan Launch lengkap", "tags": [ "Launch account licensing" ], "x-management-reference": { "group": "integration" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/launch/connections/{id}/events/{event}": { "get": { "description": "Baca hasil peristiwa perdagangan Launch. Keputusan, percobaan ulang, dan pemeriksaan cakupan dilakukan oleh Licentivo.", "operationId": "launch_get__api_v1_launch_connections_id_events_event_", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } }, { "in": "path", "name": "event", "required": true, "schema": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "attempts": 1, "available_at": "2026-10-24T00:00:00Z", "connection_id": "11111111-1111-4111-8111-111111111111", "event_id": "11111111-1111-4111-8111-111111111111", "status": "pending" }, "request_id": "request_id_example" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LaunchEvent", "description": "Hasil operasi ini." }, "request_id": { "description": "Pengenal korelasi permintaan HTTP.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Hasil yang diterima" }, "400": { "description": "Input tidak valid" }, "401": { "description": "Autentikasi atau assertion identitas ditolak" }, "403": { "description": "Hak, kredensial, lingkungan, atau login dicabut" }, "409": { "description": "Konflik versi idempotensi, kebijakan, peninjauan, atau pengikatan" }, "503": { "description": "Kegagalan sementara; coba ulang operasi asli" } }, "security": [ { "managementKey": [] }, { "session": [] } ], "summary": "Baca hasil peristiwa perdagangan Launch", "tags": [ "Launch account licensing" ], "x-management-reference": { "group": "integration" }, "x-required-scope": "read" } }, "/api/v1/launch/connections/{id}/events/{event}/retry": { "post": { "description": "Coba ulang peristiwa Launch yang belum diterapkan. Keputusan, percobaan ulang, dan pemeriksaan cakupan dilakukan oleh Licentivo.", "operationId": "launch_post__api_v1_launch_connections_id_events_event_retry", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } }, { "in": "path", "name": "event", "required": true, "schema": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": {}, "schema": { "additionalProperties": false, "properties": {}, "required": [], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": {}, "request_id": "request_id_example" }, "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "description": "Hasil operasi ini.", "properties": { "queued": { "description": "Apakah koneksi kepercayaan ini dapat mengotorisasi penggunaan runtime baru.", "type": "boolean" } }, "required": [], "type": "object" }, "request_id": { "description": "Pengenal korelasi permintaan HTTP.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Hasil yang diterima" }, "400": { "description": "Input tidak valid" }, "401": { "description": "Autentikasi atau assertion identitas ditolak" }, "403": { "description": "Hak, kredensial, lingkungan, atau login dicabut" }, "409": { "description": "Konflik versi idempotensi, kebijakan, peninjauan, atau pengikatan" }, "503": { "description": "Kegagalan sementara; coba ulang operasi asli" } }, "security": [ { "managementKey": [] }, { "session": [] } ], "summary": "Coba ulang peristiwa Launch yang belum diterapkan", "tags": [ "Launch account licensing" ], "x-management-reference": { "group": "integration" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/launch/connections/{id}/plans/{plan}": { "put": { "description": "Petakan versi paket Launch ke kebijakan lisensi. Keputusan, percobaan ulang, dan pemeriksaan cakupan dilakukan oleh Licentivo.", "operationId": "launch_put__api_v1_launch_connections_id_plans_plan_", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } }, { "in": "path", "name": "plan", "required": true, "schema": { "description": "Referensi hak pembelian yang tidak dapat diubah dan peka huruf besar/kecil.", "pattern": "^[A-Za-z0-9_-]{1,128}$", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "launch_product_id": "11111111-1111-4111-8111-111111111111", "policy_id": "11111111-1111-4111-8111-111111111111", "policy_version": 1, "product_id": "11111111-1111-4111-8111-111111111111" }, "schema": { "$ref": "#/components/schemas/LaunchPlanMappingInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": {}, "request_id": "request_id_example" }, "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "description": "Hasil operasi ini.", "properties": { "saved": { "description": "Apakah koneksi kepercayaan ini dapat mengotorisasi penggunaan runtime baru.", "type": "boolean" } }, "required": [], "type": "object" }, "request_id": { "description": "Pengenal korelasi permintaan HTTP.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Hasil yang diterima" }, "400": { "description": "Input tidak valid" }, "401": { "description": "Autentikasi atau assertion identitas ditolak" }, "403": { "description": "Hak, kredensial, lingkungan, atau login dicabut" }, "409": { "description": "Konflik versi idempotensi, kebijakan, peninjauan, atau pengikatan" }, "503": { "description": "Kegagalan sementara; coba ulang operasi asli" } }, "security": [ { "managementKey": [] }, { "session": [] } ], "summary": "Petakan versi paket Launch ke kebijakan lisensi", "tags": [ "Launch account licensing" ], "x-management-reference": { "group": "integration" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/launch/connections/{id}/session-revocations": { "post": { "description": "Pencabutan atomik sinkron: HTTP 200 berarti sesi, kredensial, pengikatan perangkat yang cocok, dan tanda terima persisten telah dikomit. Koneksi menentukan lingkungan; environment opsional yang tidak kosong harus cocok. Penghilangan dan nilai eksplisit yang cocok setara untuk idempotensi. Gunakan kembali event_id dan isi ternormalisasi yang sama untuk percobaan ulang, termasuk percobaan bersamaan; isi berbeda menyebabkan konflik. Replay yang berhasil mengembalikan jumlah asli dan tidak mencabut login yang lebih baru. Akun/sid yang tidak dikenal berhasil dengan nol baris terdampak dan mempertahankan penanda penolakan login. Cakupan akun mencatat cutoff autentikasi berdasarkan waktu penerimaan server. Masa berlaku hak pembelian dan ketentuan lisensi dipertahankan. Koneksi yang dinonaktifkan menerima pencabutan.", "operationId": "launch_post__api_v1_launch_connections_id_session_revocations", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "account_ref": "account_456", "event_id": "11111111-1111-4111-8111-111111111111", "reason": "forced_logout", "scope": "session", "sid": "login_123" }, "schema": { "$ref": "#/components/schemas/LaunchSessionRevocationInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "account_ref": "account_456", "completed_at": "2026-10-24T05:00:00.145678Z", "connection_id": "11111111-1111-4111-8111-111111111111", "created_at": "2026-10-24T05:00:00.123456Z", "environment": "live", "event_id": "11111111-1111-4111-8111-111111111111", "reason": "forced_logout", "released_devices": 2, "revoked_credentials": 2, "revoked_sessions": 2, "scope": "session", "sid": "login_123", "status": "succeeded" }, "request_id": "request_id_example" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LaunchSessionRevocation", "description": "Hasil operasi ini." }, "request_id": { "description": "Pengenal korelasi permintaan HTTP.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Hasil yang diterima" }, "400": { "description": "Input tidak valid" }, "401": { "description": "Autentikasi atau assertion identitas ditolak" }, "403": { "description": "Hak, kredensial, lingkungan, atau login dicabut" }, "404": { "description": "Koneksi tidak ada dalam tenant ini" }, "409": { "description": "Konflik versi idempotensi, kebijakan, peninjauan, atau pengikatan" }, "415": { "description": "Gunakan Content-Type: application/json" }, "500": { "description": "Kegagalan basis data atau hasil tidak diketahui; periksa atau coba ulang peristiwa asli tanpa mengubah ID atau isinya" }, "503": { "description": "Kegagalan sementara; coba ulang operasi asli" } }, "security": [ { "managementKey": [] }, { "session": [] } ], "summary": "Cabut login Launch atau semua sesi otorisasi akun", "tags": [ "Launch account licensing" ], "x-management-reference": { "group": "integration" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/launch/connections/{id}/session-revocations/{event}": { "get": { "description": "Mengembalikan tanda terima persisten asli untuk tenant dan koneksi ini. HTTP 404 berarti belum ada hasil yang dikomit dan terlihat saat ini; coba ulang POST asli dengan event_id dan isi yang sama. Tidak diperlukan worker asinkron.", "operationId": "launch_get__api_v1_launch_connections_id_session_revocations_event_", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } }, { "in": "path", "name": "event", "required": true, "schema": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "account_ref": "account_456", "completed_at": "2026-10-24T05:00:00.145678Z", "connection_id": "11111111-1111-4111-8111-111111111111", "created_at": "2026-10-24T05:00:00.123456Z", "environment": "live", "event_id": "11111111-1111-4111-8111-111111111111", "reason": "forced_logout", "released_devices": 2, "revoked_credentials": 2, "revoked_sessions": 2, "scope": "session", "sid": "login_123", "status": "succeeded" }, "request_id": "request_id_example" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LaunchSessionRevocation", "description": "Hasil operasi ini." }, "request_id": { "description": "Pengenal korelasi permintaan HTTP.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Hasil yang diterima" }, "400": { "description": "Input tidak valid" }, "401": { "description": "Autentikasi atau assertion identitas ditolak" }, "403": { "description": "Hak, kredensial, lingkungan, atau login dicabut" }, "404": { "description": "Tidak ada hasil yang dikomit dalam tenant dan koneksi ini" }, "409": { "description": "Konflik versi idempotensi, kebijakan, peninjauan, atau pengikatan" }, "500": { "description": "Kegagalan basis data atau hasil tidak diketahui; periksa atau coba ulang peristiwa asli tanpa mengubah ID atau isinya" }, "503": { "description": "Kegagalan sementara; coba ulang operasi asli" } }, "security": [ { "managementKey": [] }, { "session": [] } ], "summary": "Periksa hasil pencabutan sesi Launch yang telah dikomit", "tags": [ "Launch account licensing" ], "x-management-reference": { "group": "integration" }, "x-required-scope": "read" } }, "/api/v1/launch/device-operations/{operation}": { "get": { "description": "Baca kemajuan pelepasan jarak jauh. Keputusan, percobaan ulang, dan pemeriksaan cakupan dilakukan oleh Licentivo.", "operationId": "launch_get__api_v1_launch_device_operations_operation_", "parameters": [ { "in": "path", "name": "operation", "required": true, "schema": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "activation_id": "11111111-1111-4111-8111-111111111111", "expected_generation": 1, "license_id": "11111111-1111-4111-8111-111111111111", "operation_id": "11111111-1111-4111-8111-111111111111", "source": "logout", "status": "pending" }, "request_id": "request_id_example" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/DeviceReleaseOperation", "description": "Hasil operasi ini." }, "request_id": { "description": "Pengenal korelasi permintaan HTTP.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Hasil yang diterima" }, "400": { "description": "Input tidak valid" }, "401": { "description": "Autentikasi atau assertion identitas ditolak" }, "403": { "description": "Hak, kredensial, lingkungan, atau login dicabut" }, "409": { "description": "Konflik versi idempotensi, kebijakan, peninjauan, atau pengikatan" }, "503": { "description": "Kegagalan sementara; coba ulang operasi asli" } }, "security": [ { "managementKey": [] }, { "session": [] } ], "summary": "Baca kemajuan pelepasan jarak jauh", "tags": [ "Launch account licensing" ], "x-management-reference": { "group": "integration" }, "x-required-scope": "read" } }, "/api/v1/launch/device-operations/{operation}/retry": { "post": { "description": "Operasi manual_review memerlukan approve=true dari owner. Persetujuan tidak pernah melewati versi pengikatan asli.", "operationId": "launch_post__api_v1_launch_device_operations_operation_retry", "parameters": [ { "in": "path", "name": "operation", "required": true, "schema": { "description": "UUID resource Licentivo.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": {}, "schema": { "additionalProperties": false, "properties": { "approve": { "description": "Apakah koneksi kepercayaan ini dapat mengotorisasi penggunaan runtime baru.", "type": "boolean" } }, "required": [], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": {}, "request_id": "request_id_example" }, "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "description": "Hasil operasi ini.", "properties": { "queued": { "description": "Apakah koneksi kepercayaan ini dapat mengotorisasi penggunaan runtime baru.", "type": "boolean" } }, "required": [], "type": "object" }, "request_id": { "description": "Pengenal korelasi permintaan HTTP.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Hasil yang diterima" }, "400": { "description": "Input tidak valid" }, "401": { "description": "Autentikasi atau assertion identitas ditolak" }, "403": { "description": "Hak, kredensial, lingkungan, atau login dicabut" }, "409": { "description": "Konflik versi idempotensi, kebijakan, peninjauan, atau pengikatan" }, "503": { "description": "Kegagalan sementara; coba ulang operasi asli" } }, "security": [ { "managementKey": [] }, { "session": [] } ], "summary": "Coba ulang atau setujui secara eksplisit pelepasan yang telah ditinjau", "tags": [ "Launch account licensing" ], "x-management-reference": { "group": "integration" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/launch/exchange": { "post": { "description": "Idempotency-Key wajib. Header JWT alg=Ed25519, typ=licentivo-launch-identity+jwt dan kid yang dipatok; iss/aud/environment, sub, sid, jti, iat, nbf, exp, auth_time, session_exp, launch_product_id, product_id dan entitlement_ref yang tepat wajib ada. Masa berlaku assertion maksimal 120 detik. Replay hanya memulihkan sesi perangkat aktif yang sama dengan permintaan dan kunci idempotensi yang sama. Pembelian dibaca secara eksklusif dari Licentivo.", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "description": "Idempotency-Key untuk operasi otorisasi Launch ini.", "maxLength": 80, "minLength": 1, "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "device_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "environment": "live", "identity_token": "identity_token_example", "launch_connection_id": "11111111-1111-4111-8111-111111111111", "product_id": "11111111-1111-4111-8111-111111111111" }, "schema": { "$ref": "#/components/schemas/LaunchExchangeInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "activation_id": "11111111-1111-4111-8111-111111111111" }, "request_id": "request_id_example" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/RuntimeResult", "description": "Hasil operasi ini." }, "request_id": { "description": "Pengenal korelasi permintaan HTTP.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Hasil yang diterima" }, "400": { "description": "Input tidak valid" }, "401": { "description": "Autentikasi atau assertion identitas ditolak" }, "403": { "description": "Hak, kredensial, lingkungan, atau login dicabut" }, "409": { "description": "Konflik versi idempotensi, kebijakan, peninjauan, atau pengikatan" }, "503": { "description": "Kegagalan sementara; coba ulang operasi asli" } }, "security": [], "summary": "Tukarkan identitas akun Launch untuk otorisasi perangkat", "tags": [ "Launch account licensing" ] } }, "/api/v1/legal/policy": { "get": { "description": "Mengembalikan dokumen layanan, pengembalian dana, dan privasi yang dibekukan dalam seluruh 13 bahasa yang didukung. Detail profil opsional yang belum dikonfirmasi dihilangkan. Versi yang diterbitkan memerlukan persetujuan eksplisit; alur yang ada berlanjut hingga publikasi pertama.", "operationId": "get__api_v1_legal_policy", "parameters": [ { "in": "query", "name": "version", "schema": { "type": "string" } }, { "in": "query", "name": "locale", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CommercePolicy" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [], "summary": "Baca kebijakan hukum yang tidak dapat diubah" } }, "/api/v1/licenses": { "get": { "operationId": "get_api_v1_licenses", "parameters": [ { "in": "query", "name": "limit", "schema": { "default": 25, "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "maximum": 100000, "minimum": 0, "type": "integer" } }, { "in": "query", "name": "product_id", "schema": { "description": "UUID produk di ruang kerja saat ini.", "format": "uuid", "type": "string" } }, { "in": "query", "name": "q", "schema": { "description": "Teks pencarian; bidang target dan panjang maksimum bergantung pada operasi.", "maxLength": 254, "type": "string" } }, { "in": "query", "name": "status", "schema": { "description": "Status resource saat ini; lihat enum dan catatan operasi.", "enum": [ "active", "expired", "suspended", "revoked" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "created_at": "2026-10-18T00:00:00Z", "customer": "Order #1001", "duration_days": 30, "expires_at": null, "features": [ "export" ], "first_activated_at": null, "id": "33333333-3333-4333-8333-333333333333", "key_prefix": "lv_lic_AAAAAAA", "max_devices": 1, "mode": "timed", "policy_id": "22222222-2222-4222-8222-222222222222", "policy_version": 1, "product_id": "11111111-1111-4111-8111-111111111111", "status": "active", "updated_at": "2026-10-18T00:00:00Z" } ], "limit": 25, "offset": 0, "total": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LicenseList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar lisensi", "x-management-reference": { "group": "licenses" }, "x-required-scope": "read" }, "post": { "description": "Memerlukan sesi Owner atau kunci tulis dari Owner aktif. Tidak ada percobaan ulang Idempotency-Key otomatis.", "operationId": "post_api_v1_licenses", "parameters": [], "requestBody": { "content": { "application/json": { "example": { "customer": "Order #1001", "customer_email": "buyer@example.com", "duration_days": 30, "policy_id": "22222222-2222-4222-8222-222222222222", "product_id": "11111111-1111-4111-8111-111111111111" }, "schema": { "$ref": "#/components/schemas/LicenseCreate" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "example": { "data": { "duration_days": 30, "expires_at": null, "first_activated_at": null, "id": "33333333-3333-4333-8333-333333333333", "key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "key_prefix": "lv_lic_AAAAAAA" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LicenseSecret", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Terbitkan lisensi", "x-management-reference": { "group": "licenses" }, "x-request-variants": [ { "name": "timed", "request": { "customer": "Order #1001", "customer_email": "buyer@example.com", "duration_days": 30, "policy_id": "22222222-2222-4222-8222-222222222222", "product_id": "11111111-1111-4111-8111-111111111111" }, "response": { "data": { "duration_days": 30, "expires_at": null, "first_activated_at": null, "id": "33333333-3333-4333-8333-333333333333", "key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "key_prefix": "lv_lic_AAAAAAA" }, "request_id": "55555555-5555-4555-8555-555555555555" } }, { "name": "perpetual", "request": { "customer": "Order #1001", "customer_email": "buyer@example.com", "duration_days": null, "policy_id": "22222222-2222-4222-8222-222222222223", "product_id": "11111111-1111-4111-8111-111111111111" }, "response": { "data": { "duration_days": null, "expires_at": null, "first_activated_at": null, "id": "33333333-3333-4333-8333-333333333333", "key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "key_prefix": "lv_lic_AAAAAAA" }, "request_id": "55555555-5555-4555-8555-555555555555" } } ], "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/licenses/batch": { "post": { "description": "Penerapan kebijakan tidak pernah mengubah mode atau masa berlaku lisensi. Pembuatan memerlukan durasi eksplisit untuk setiap lisensi timed/trial, dari entrinya atau bidang batch bersama. Lisensi yang dikelola Launch menolak perpanjangan tunggal atau batch independen dengan HTTP 409 LAUNCH_VALIDITY_MANAGED; perpanjang pembelian di Launch dan sinkronkan masa berlaku absolut. Batch perpanjangan campuran dibatalkan seluruhnya.", "operationId": "post_api_v1_licenses_batch", "parameters": [], "requestBody": { "content": { "application/json": { "example": { "duration_days": 30, "entries": [ { "customer": "Order #1001", "customer_email": "buyer@example.com" } ], "operation": "create", "policy_id": "22222222-2222-4222-8222-222222222222", "product_id": "11111111-1111-4111-8111-111111111111", "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/BatchInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "count": 1, "items": [ { "customer": "Order #1001", "customer_email": "buyer@example.com", "duration_days": 30, "expires_at": null, "first_activated_at": null, "id": "33333333-3333-4333-8333-333333333333", "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" } ], "operation": "create", "request_id": "55555555-5555-4555-8555-555555555555" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/BatchResult", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Lisensi batch", "x-management-reference": { "group": "licenses" }, "x-request-variants": [ { "name": "create", "request": { "duration_days": 30, "entries": [ { "customer": "Order #1001", "customer_email": "buyer@example.com" } ], "operation": "create", "policy_id": "22222222-2222-4222-8222-222222222222", "product_id": "11111111-1111-4111-8111-111111111111", "request_id": "55555555-5555-4555-8555-555555555555" }, "response": { "data": { "count": 1, "items": [ { "customer": "Order #1001", "customer_email": "buyer@example.com", "duration_days": 30, "expires_at": null, "first_activated_at": null, "id": "33333333-3333-4333-8333-333333333333", "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" } ], "operation": "create", "request_id": "55555555-5555-4555-8555-555555555555" }, "request_id": "55555555-5555-4555-8555-555555555555" } }, { "name": "renew", "request": { "days": 30, "ids": [ "33333333-3333-4333-8333-333333333333" ], "operation": "renew", "request_id": "55555555-5555-4555-8555-555555555555" }, "response": { "data": { "count": 1, "items": [ { "id": "33333333-3333-4333-8333-333333333333", "operation": "renew" } ], "operation": "renew", "request_id": "55555555-5555-4555-8555-555555555555" }, "request_id": "55555555-5555-4555-8555-555555555555" } }, { "name": "revoke", "request": { "ids": [ "33333333-3333-4333-8333-333333333333" ], "operation": "revoke", "request_id": "55555555-5555-4555-8555-555555555555" }, "response": { "data": { "count": 1, "items": [ { "id": "33333333-3333-4333-8333-333333333333", "operation": "revoke" } ], "operation": "revoke", "request_id": "55555555-5555-4555-8555-555555555555" }, "request_id": "55555555-5555-4555-8555-555555555555" } }, { "name": "apply_policy", "request": { "ids": [ "33333333-3333-4333-8333-333333333333" ], "operation": "apply_policy", "policy_id": "22222222-2222-4222-8222-222222222222", "preview_token": "REPLACE_WITH_THE_UNEXPIRED_PREVIEW_TOKEN", "request_id": "55555555-5555-4555-8555-555555555555" }, "response": { "data": { "count": 1, "items": [ { "id": "33333333-3333-4333-8333-333333333333", "operation": "apply_policy" } ], "operation": "apply_policy", "request_id": "55555555-5555-4555-8555-555555555555" }, "request_id": "55555555-5555-4555-8555-555555555555" } } ], "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/licenses/export.csv": { "get": { "operationId": "get_api_v1_licenses_export_csv", "parameters": [ { "in": "query", "name": "product_id", "schema": { "description": "UUID produk di ruang kerja saat ini.", "format": "uuid", "type": "string" } }, { "in": "query", "name": "q", "schema": { "description": "Teks pencarian; bidang target dan panjang maksimum bergantung pada operasi.", "maxLength": 254, "type": "string" } }, { "in": "query", "name": "status", "schema": { "description": "Status resource saat ini; lihat enum dan catatan operasi.", "enum": [ "active", "expired", "suspended", "revoked" ], "type": "string" } } ], "responses": { "200": { "content": { "text/csv": { "example": "id,product_id,key_prefix,customer,mode,status,max_devices,expires_at\n", "schema": { "type": "string" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "413": { "content": { "application/json": { "example": { "error": { "code": "EXPORT_TOO_LARGE", "message": "Filter the export to at most 5000 records" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Filter hingga 5000 catatan" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Ekspor lisensi", "x-csv-columns": [ "id", "product_id", "key_prefix", "customer", "mode", "status", "max_devices", "expires_at" ], "x-management-reference": { "group": "licenses" }, "x-required-scope": "read" } }, "/api/v1/licenses/policy-preview": { "post": { "description": "Penerapan kebijakan tidak pernah mengubah mode atau masa berlaku lisensi. Pembuatan memerlukan durasi eksplisit untuk setiap lisensi timed/trial, dari entrinya atau bidang batch bersama.", "operationId": "post_api_v1_licenses_policy-preview", "parameters": [], "requestBody": { "content": { "application/json": { "example": { "ids": [ "33333333-3333-4333-8333-333333333333" ], "policy_id": "22222222-2222-4222-8222-222222222222" }, "schema": { "$ref": "#/components/schemas/PreviewInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "changes": [], "expires_in": 600, "note": "", "policy_version": 1, "preview_token": "" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PolicyPreview", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Pratinjau penerapan kebijakan", "x-management-reference": { "group": "licenses" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/licenses/{id}": { "delete": { "operationId": "delete_api_v1_licenses_by_id", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ID", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Arsipkan lisensi", "x-management-reference": { "group": "licenses" }, "x-required-role": "owner", "x-required-scope": "write" }, "get": { "operationId": "get_api_v1_licenses_by_id", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "created_at": "2026-10-18T00:00:00Z", "customer": "Order #1001", "duration_days": 30, "expires_at": null, "features": [ "export" ], "first_activated_at": null, "id": "33333333-3333-4333-8333-333333333333", "key_prefix": "lv_lic_AAAAAAA", "max_devices": 1, "mode": "timed", "policy_id": "22222222-2222-4222-8222-222222222222", "policy_version": 1, "product_id": "11111111-1111-4111-8111-111111111111", "status": "active", "updated_at": "2026-10-18T00:00:00Z" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/License", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Baca lisensi", "x-management-reference": { "group": "licenses" }, "x-required-scope": "read" }, "patch": { "operationId": "patch_api_v1_licenses_by_id", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "status": "suspended" }, "schema": { "$ref": "#/components/schemas/LicenseUpdate" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ID", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Perbarui lisensi", "x-management-reference": { "group": "licenses" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/licenses/{id}/capabilities": { "get": { "operationId": "get_api_v1_licenses_by_id_capabilities", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "customer_email": "buyer@example.com", "license": { "license_id": "33333333-3333-4333-8333-333333333333", "license_model": "node_locked", "maintenance_days": 0, "maintenance_until": null, "max_version": "", "min_version": "", "product_id": "11111111-1111-4111-8111-111111111111", "updated_at": "2026-10-18T00:00:00Z" }, "meter_rules": [], "usage": null }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LicenseCapabilityResult", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Baca kemampuan lisensi", "x-management-reference": { "group": "licenses" }, "x-required-scope": "read" } }, "/api/v1/licenses/{id}/customer": { "patch": { "operationId": "patch_api_v1_licenses_by_id_customer", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "email": "buyer@example.com", "name": "Sample customer" }, "schema": { "$ref": "#/components/schemas/CustomerAssignment" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ID", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Tetapkan pelanggan", "x-management-reference": { "group": "licenses" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/licenses/{id}/maintenance/renew": { "post": { "operationId": "post_api_v1_licenses_by_id_maintenance_renew", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "days": 30 }, "schema": { "$ref": "#/components/schemas/Renew" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "license_id": "33333333-3333-4333-8333-333333333333", "license_model": "node_locked", "maintenance_days": 0, "maintenance_until": null, "max_version": "", "min_version": "", "product_id": "11111111-1111-4111-8111-111111111111", "updated_at": "2026-10-18T00:00:00Z" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LicenseCapabilities", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Perpanjang pemeliharaan", "x-management-reference": { "group": "licenses" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/licenses/{id}/renew": { "post": { "description": "Sebelum aktivasi pertama, perpanjangan menambah duration_days. Setelah aktivasi, perpanjangan dimulai dari waktu yang lebih akhir antara waktu saat ini dan expires_at; lisensi kedaluwarsa tidak kehilangan waktu perpanjangan yang dibeli. Lisensi yang dikelola Launch menolak perpanjangan tunggal atau batch independen dengan HTTP 409 LAUNCH_VALIDITY_MANAGED; perpanjang pembelian di Launch dan sinkronkan masa berlaku absolut. Batch perpanjangan campuran dibatalkan seluruhnya.", "operationId": "post_api_v1_licenses_by_id_renew", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "days": 30 }, "schema": { "$ref": "#/components/schemas/Renew" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "duration_days": 60, "expires_at": null, "id": "33333333-3333-4333-8333-333333333333" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Renewed", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Perpanjang lisensi", "x-management-reference": { "group": "licenses" }, "x-request-variants": [ { "name": "before_activation", "request": { "days": 30 }, "response": { "data": { "duration_days": 60, "expires_at": null, "id": "33333333-3333-4333-8333-333333333333" }, "request_id": "55555555-5555-4555-8555-555555555555" } }, { "name": "after_activation", "request": { "days": 30 }, "response": { "data": { "duration_days": 30, "expires_at": "2026-12-17T00:00:00Z", "id": "33333333-3333-4333-8333-333333333333" }, "request_id": "55555555-5555-4555-8555-555555555555" } } ], "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/licenses/{id}/reveal-key": { "post": { "description": "Requires an active Owner browser session and CSRF token. Management API keys and read-only members are forbidden. Keys are encrypted at rest and each view is audited without recording the secret. Ordinary lists, details and CSV exports contain only the prefix. Older encrypted batch/onboarding receipts are recovered during migration. Older hash-only issuances return LICENSE_KEY_UNAVAILABLE (409); Launch account licenses return LICENSE_KEY_NOT_APPLICABLE (409). Viewing does not rotate the key or change validity, devices or usage.", "operationId": "post_api_v1_licenses_by_id_reveal-key", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } }, { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LicenseKeyReveal" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "View the original license key", "x-required-role": "owner" } }, "/api/v1/licenses/{id}/revoke": { "post": { "operationId": "post_api_v1_licenses_by_id_revoke", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": {}, "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ID", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Cabut lisensi", "x-management-reference": { "group": "licenses" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/members": { "get": { "operationId": "get_api_v1_members", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/MemberList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "get /members", "x-required-role": "owner" }, "post": { "operationId": "post_api_v1_members", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Invite" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Invited" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "post /members", "x-required-role": "owner" } }, "/api/v1/members/{id}": { "patch": { "operationId": "patch_api_v1_members_by_id", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } }, { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MemberUpdate" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ID" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "patch /members/{id}", "x-required-role": "owner" } }, "/api/v1/offline/respond": { "post": { "operationId": "post_api_v1_offline_respond", "parameters": [], "requestBody": { "content": { "application/json": { "example": { "activation_id": "44444444-4444-4444-8444-444444444444", "app_version": "1.0.0", "created_at": 1792281600, "device_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "device_name": "Office PC", "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "operation": "deactivate", "product_id": "11111111-1111-4111-8111-111111111111", "request_id": "55555555-5555-4555-8555-555555555555", "version": 1 }, "schema": { "$ref": "#/components/schemas/OfflineRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "operation": "deactivate", "request_id": "55555555-5555-4555-8555-555555555555", "result": { "activation_id": "44444444-4444-4444-8444-444444444444", "deactivated": true }, "version": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/OfflineResponse", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Terbitkan respons offline", "x-management-reference": { "group": "integration" }, "x-request-variants": [ { "name": "activate", "request": { "app_version": "1.0.0", "created_at": 1792281600, "device_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "device_name": "Office PC", "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "operation": "activate", "product_id": "11111111-1111-4111-8111-111111111111", "request_id": "55555555-5555-4555-8555-555555555555", "version": 1 }, "response": { "data": { "operation": "activate", "request_id": "55555555-5555-4555-8555-555555555555", "result": { "activation_id": "44444444-4444-4444-8444-444444444444", "device_key": "lv_dev_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "heartbeat_seconds": 600, "lease": { "key_id": "66666666-6666-4666-8666-666666666666", "payload": "BASE64URL_ENCODED_SIGNED_CLAIMS", "signature": "BASE64URL_ED25519_SIGNATURE", "version": 1 } }, "version": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" } }, { "name": "deactivate", "request": { "activation_id": "44444444-4444-4444-8444-444444444444", "app_version": "1.0.0", "created_at": 1792281600, "device_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "device_name": "Office PC", "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "operation": "deactivate", "product_id": "11111111-1111-4111-8111-111111111111", "request_id": "55555555-5555-4555-8555-555555555555", "version": 1 }, "response": { "data": { "operation": "deactivate", "request_id": "55555555-5555-4555-8555-555555555555", "result": { "activation_id": "44444444-4444-4444-8444-444444444444", "deactivated": true }, "version": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" } } ], "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/onboarding": { "post": { "operationId": "post_api_v1_onboarding", "parameters": [], "requestBody": { "content": { "application/json": { "example": { "duration_days": 7, "mode": "trial", "name": "Report app", "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/OnboardingInput" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "example": { "data": { "config": { "allow_http": false, "app_version": "1.0.0", "base_url": "https://license.example.com", "cache_path": "", "device_name": "My application", "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "product_id": "11111111-1111-4111-8111-111111111111", "trusted_keys": { "66666666-6666-4666-8666-666666666666": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" } }, "license_id": "33333333-3333-4333-8333-333333333333", "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "next": "Choose a language and download the configured SDK bundle.", "policy_id": "22222222-2222-4222-8222-222222222222", "product_id": "11111111-1111-4111-8111-111111111111" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/OnboardingResult", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Buat resource integrasi", "x-management-reference": { "group": "integration" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/payments/paddle/webhook": { "post": { "operationId": "post__api_v1_payments_paddle_webhook", "parameters": [ { "in": "header", "name": "Paddle-Signature", "required": true, "schema": { "description": "Nama tampilan layanan pembayaran.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaddleWebhookEvent" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WebhookReceived" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [], "summary": "Verifikasi tanda tangan Paddle dan rekonsiliasi pembayaran atau penyesuaian yang selesai", "x-licentivo-access": "public" } }, "/api/v1/payments/paypal/webhook": { "post": { "operationId": "post_api_v1_payments_paypal_webhook", "parameters": [ { "in": "header", "name": "Paypal-Auth-Algo", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Paypal-Cert-Url", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Paypal-Transmission-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Paypal-Transmission-Sig", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Paypal-Transmission-Time", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookEvent" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WebhookReceived" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "Notifikasi capture/refund/reversal terverifikasi" } }, "/api/v1/payments/waffo/webhook": { "post": { "operationId": "post__api_v1_payments_waffo_webhook", "parameters": [ { "in": "header", "name": "X-Waffo-Signature", "required": true, "schema": { "description": "Pengenal pedagang yang dimulai dengan MER_.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WaffoWebhookEvent" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WebhookReceived" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [], "summary": "Verifikasi tanda tangan Waffo dan rekonsiliasi pembayaran atau pengembalian dana", "x-licentivo-access": "public" } }, "/api/v1/policies": { "get": { "operationId": "get_api_v1_policies", "parameters": [ { "in": "query", "name": "limit", "schema": { "default": 25, "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "maximum": 100000, "minimum": 0, "type": "integer" } }, { "in": "query", "name": "product_id", "schema": { "description": "UUID produk di ruang kerja saat ini.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "created_at": "2026-10-18T00:00:00Z", "features": [ "export" ], "heartbeat_seconds": 600, "id": "22222222-2222-4222-8222-222222222222", "max_devices": 1, "mode": "timed", "name": "One device", "offline_mode": "limited", "offline_seconds": 86400, "product_id": "11111111-1111-4111-8111-111111111111", "updated_at": "2026-10-18T00:00:00Z", "version": 1 } ], "limit": 25, "offset": 0, "total": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PolicyList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar kebijakan", "x-management-reference": { "group": "policies" }, "x-required-scope": "read" }, "post": { "description": "Memerlukan sesi Owner atau kunci tulis dari Owner aktif. Tidak ada percobaan ulang Idempotency-Key otomatis.", "operationId": "post_api_v1_policies", "parameters": [], "requestBody": { "content": { "application/json": { "example": { "features": [ "export" ], "heartbeat_seconds": 600, "max_devices": 1, "mode": "timed", "name": "One device", "offline_mode": "limited", "offline_seconds": 86400, "product_id": "11111111-1111-4111-8111-111111111111" }, "schema": { "$ref": "#/components/schemas/PolicyCreate" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ID", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Buat kebijakan", "x-management-reference": { "group": "policies" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/policies/{id}": { "delete": { "operationId": "delete_api_v1_policies_by_id", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ID", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Arsipkan kebijakan", "x-management-reference": { "group": "policies" }, "x-required-role": "owner", "x-required-scope": "write" }, "get": { "operationId": "get_api_v1_policies_by_id", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "created_at": "2026-10-18T00:00:00Z", "features": [ "export" ], "heartbeat_seconds": 600, "id": "22222222-2222-4222-8222-222222222222", "max_devices": 1, "mode": "timed", "name": "One device", "offline_mode": "limited", "offline_seconds": 86400, "product_id": "11111111-1111-4111-8111-111111111111", "updated_at": "2026-10-18T00:00:00Z", "version": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Policy", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Baca kebijakan", "x-management-reference": { "group": "policies" }, "x-required-scope": "read" }, "patch": { "description": "Perbarui kebijakan dan setiap snapshot lisensi terkait yang belum dicabut secara atomik. Ketentuan lisensi yang ada, penggunaan yang telah dikomit, dan perpanjangan pemeliharaan terpisah dipertahankan. Mengembalikan synced_licenses. ACTIVE_DEVICES_CONFLICT membatalkan seluruh penyimpanan.", "operationId": "patch_api_v1_policies_by_id", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "max_devices": 2 }, "schema": { "$ref": "#/components/schemas/PolicyUpdate" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333", "synced_licenses": 0 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PolicySyncResult", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Perbarui kebijakan dasar", "x-management-reference": { "group": "policies" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/policies/{id}/capabilities": { "get": { "operationId": "get_api_v1_policies_by_id_capabilities", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "allow_vm": true, "device_match": "system", "license_model": "node_locked", "maintenance_days": 0, "max_version": "", "meter_rules": [], "min_version": "", "policy_id": "22222222-2222-4222-8222-222222222222", "policy_version": 1, "product_id": "11111111-1111-4111-8111-111111111111", "require_hardware": false, "self_release_limit": 3, "session_seconds": 7200, "updated_at": "2026-10-18T00:00:00Z" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PolicyCapabilities", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Baca kemampuan kebijakan", "x-management-reference": { "group": "policies" }, "x-required-scope": "read" }, "patch": { "description": "Gunakan policy_version saat ini. Perbarui kebijakan dan setiap snapshot lisensi terkait yang belum dicabut secara atomik sambil mempertahankan ketentuan yang diterbitkan, penggunaan yang telah dikomit, dan perpanjangan pemeliharaan terpisah. Mengembalikan synced_licenses. POLICY_CHANGED atau ACTIVE_DEVICES_CONFLICT membatalkan seluruh penyimpanan.", "operationId": "patch_api_v1_policies_by_id_capabilities", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "license_model": "node_locked", "meter_rules": [ { "allow_overage": false, "feature": "export", "limit": 500, "max_overage": 0, "period": "month" } ], "policy_version": 1 }, "schema": { "$ref": "#/components/schemas/PolicyCapabilitiesInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333", "synced_licenses": 0 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PolicySyncResult", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Perbarui kemampuan kebijakan", "x-management-reference": { "group": "policies" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/products": { "get": { "operationId": "get_api_v1_products", "parameters": [ { "in": "query", "name": "limit", "schema": { "default": 25, "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "maximum": 100000, "minimum": 0, "type": "integer" } }, { "in": "query", "name": "q", "schema": { "description": "Teks pencarian; bidang target dan panjang maksimum bergantung pada operasi.", "maxLength": 120, "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "created_at": "2026-10-18T00:00:00Z", "description": "Desktop reporting software", "id": "11111111-1111-4111-8111-111111111111", "name": "Report app", "status": "active", "updated_at": "2026-10-18T00:00:00Z" } ], "limit": 25, "offset": 0, "total": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ProductList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar produk", "x-management-reference": { "group": "products" }, "x-required-scope": "read" }, "post": { "description": "Memerlukan sesi Owner atau kunci tulis dari Owner aktif. Tidak ada percobaan ulang Idempotency-Key otomatis.", "operationId": "post_api_v1_products", "parameters": [], "requestBody": { "content": { "application/json": { "example": { "description": "Desktop reporting software", "name": "Report app" }, "schema": { "$ref": "#/components/schemas/ProductCreate" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ID", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Buat produk", "x-management-reference": { "group": "products" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/products/{id}": { "delete": { "operationId": "delete_api_v1_products_by_id", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ID", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Arsipkan produk", "x-management-reference": { "group": "products" }, "x-required-role": "owner", "x-required-scope": "write" }, "get": { "operationId": "get_api_v1_products_by_id", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "created_at": "2026-10-18T00:00:00Z", "description": "Desktop reporting software", "id": "11111111-1111-4111-8111-111111111111", "name": "Report app", "status": "active", "updated_at": "2026-10-18T00:00:00Z" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Product", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Baca produk", "x-management-reference": { "group": "products" }, "x-required-scope": "read" }, "patch": { "operationId": "patch_api_v1_products_by_id", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "name": "Report app Pro", "status": "active" }, "schema": { "$ref": "#/components/schemas/ProductUpdate" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ID", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Perbarui produk", "x-management-reference": { "group": "products" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/products/{id}/public-keys": { "get": { "operationId": "get_api_v1_products_by_id_public-keys", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/KeyBundle" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "Bundel kunci produk yang dipatok" } }, "/api/v1/products/{id}/releases": { "get": { "operationId": "get_api_v1_products_by_id_releases", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } }, { "in": "query", "name": "limit", "schema": { "default": 25, "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "maximum": 100000, "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "channel": "stable", "created_at": "2026-10-18T00:00:00Z", "download_url": "", "id": "33333333-3333-4333-8333-333333333333", "notes": "Initial release", "product_id": "11111111-1111-4111-8111-111111111111", "published_at": "2026-10-18T00:00:00Z", "sha256": "", "version": "1.0.0" } ], "limit": 25, "offset": 0, "total": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ReleaseList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar rilis", "x-management-reference": { "group": "releases" }, "x-required-scope": "read" }, "post": { "operationId": "post_api_v1_products_by_id_releases", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "channel": "stable", "notes": "Initial release", "version": "1.0.0" }, "schema": { "$ref": "#/components/schemas/ReleaseInput" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "example": { "data": { "channel": "stable", "created_at": "2026-10-18T00:00:00Z", "download_url": "", "id": "33333333-3333-4333-8333-333333333333", "notes": "Initial release", "product_id": "11111111-1111-4111-8111-111111111111", "published_at": "2026-10-18T00:00:00Z", "sha256": "", "version": "1.0.0" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Release", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Terbitkan rilis", "x-management-reference": { "group": "releases" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/products/{id}/sdk-bundle": { "post": { "operationId": "post_api_v1_products_by_id_sdk-bundle", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "language": "go" }, "schema": { "$ref": "#/components/schemas/BundleInput" } } }, "required": true }, "responses": { "200": { "content": { "application/zip": { "schema": { "format": "binary", "type": "string" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Unduh kode sumber contoh produk", "x-management-reference": { "group": "products" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/products/{id}/sdk-initializer": { "get": { "operationId": "get_api_v1_products_by_id_sdk-initializer", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } }, { "in": "query", "name": "language", "schema": { "default": "go", "description": "Pengenal bahasa SDK untuk bundel unduhan.", "enum": [ "go", "java", "c", "cpp", "csharp", "python", "javascript", "rust", "ruby" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "language": "go", "product_id": "11111111-1111-4111-8111-111111111111", "source": "const productID = \"11111111-1111-4111-8111-111111111111\"\nvar trustedKeys = map[string]string{\"66666666-6666-4666-8666-666666666666\": \"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\"}\n", "trusted_keys": { "66666666-6666-4666-8666-666666666666": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" } }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SDKInitializer", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Salin kode inisialisasi produk", "x-management-reference": { "group": "products" }, "x-required-scope": "read" } }, "/api/v1/products/{id}/signing-keys": { "get": { "operationId": "get_api_v1_products_by_id_signing-keys", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "keys": [], "product_id": "11111111-1111-4111-8111-111111111111" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ManagementKeyBundle", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar kunci penandatanganan", "x-management-reference": { "group": "products" }, "x-required-scope": "read" } }, "/api/v1/products/{id}/signing-keys/rotate": { "post": { "operationId": "post_api_v1_products_by_id_signing-keys_rotate", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": {}, "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "example": { "data": { "active": true, "algorithm": "Ed25519", "created_at": "2026-10-18T00:00:00Z", "key_id": "66666666-6666-4666-8666-666666666666", "public_key": "", "retired_at": null }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SigningKey", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Rotasi kunci penandatanganan", "x-management-reference": { "group": "products" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/releases/eligible": { "post": { "description": "Operasi runtime yang diautentikasi lisensi; tanpa cookie vendor atau API Key. Konsumsi fitur memerlukan Idempotency-Key yang stabil; consume tidak mendebit API platform.", "operationId": "post_api_v1_releases_eligible", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RuntimeInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/EligibleReleases" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "/releases/eligible" } }, "/api/v1/service/status": { "get": { "description": "Hanya pemberitahuan global yang publik; ID ruang kerja yang ditargetkan tidak diungkap.", "operationId": "get__api_v1_service_status", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ServiceIncidentList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [], "summary": "Baca pemeliharaan dan insiden publik" } }, "/api/v1/sessions/logout": { "post": { "description": "Tanpa cookie browser atau token CSRF. Operasi duplikat diputar ulang tanpa melepas pengikatan yang lebih baru. Status stale adalah penyelesaian berhasil dari pencabutan yang sudah usang. SDK menolak penggunaan lokal dan membersihkan kredensial runtime sebelum mengirim permintaan ini.", "parameters": [], "requestBody": { "content": { "application/json": { "example": { "activation_id": "11111111-1111-4111-8111-111111111111", "expected_generation": 1, "operation_id": "11111111-1111-4111-8111-111111111111", "product_id": "11111111-1111-4111-8111-111111111111", "release_token": "lv_out_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" }, "schema": { "$ref": "#/components/schemas/LogoutTicket" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "activation_id": "11111111-1111-4111-8111-111111111111", "expected_generation": 1, "license_id": "11111111-1111-4111-8111-111111111111", "operation_id": "11111111-1111-4111-8111-111111111111", "source": "logout", "status": "pending" }, "request_id": "request_id_example" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/DeviceReleaseOperation", "description": "Hasil operasi ini." }, "request_id": { "description": "Pengenal korelasi permintaan HTTP.", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Hasil yang diterima" }, "400": { "description": "Input tidak valid" }, "401": { "description": "Autentikasi atau assertion identitas ditolak" }, "403": { "description": "Hak, kredensial, lingkungan, atau login dicabut" }, "409": { "description": "Konflik versi idempotensi, kebijakan, peninjauan, atau pengikatan" }, "503": { "description": "Kegagalan sementara; coba ulang operasi asli" } }, "security": [], "summary": "Cabut satu pengikatan perangkat berversi menggunakan tiket khusus unlink", "tags": [ "Launch account licensing" ] } }, "/api/v1/summary": { "get": { "operationId": "get_api_v1_summary", "parameters": [], "responses": { "200": { "content": { "application/json": { "example": { "data": { "active_licenses": 0, "licenses": 0, "policies": 0, "products": 0 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Summary", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Jumlah ruang kerja", "x-management-reference": { "group": "usage" }, "x-required-scope": "read" } }, "/api/v1/support/contact": { "get": { "description": "Hanya mengembalikan email kontak yang dikonfigurasi; kosong berarti tersembunyi. Tidak ada email yang dikirim.", "operationId": "get__api_v1_support_contact", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportContact" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [], "summary": "Baca email dukungan publik" } }, "/api/v1/system/billing-notifications": { "get": { "description": "Menggunakan kembali transport email autentikasi, pengirim, antrean persisten terenkripsi, dan percobaan ulang. Izin platform dan persetujuan penerima harus sama-sama mengizinkan suatu jenis. Pengiriman memeriksa ulang persetujuan dan status peristiwa saat ini. Pilihan email tidak memberikan atau mencabut persetujuan untuk mendebit dompet. Pesan sandbox diberi label. Tidak ada notifikasi untuk pembelian tertunda yang belum dibayar atau hadiah.", "operationId": "get__api_v1_system_billing_notifications", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/BillingNotificationSettings" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca aturan email penagihan platform", "x-platform-admin": true, "x-required-role": "owner" }, "patch": { "description": "Pembaruan parsial; nilai false yang eksplisit dipertahankan. Menggunakan kembali transport email autentikasi, pengirim, antrean persisten terenkripsi, dan percobaan ulang. Izin platform dan persetujuan penerima harus sama-sama mengizinkan suatu jenis. Pengiriman memeriksa ulang persetujuan dan status peristiwa saat ini. Pilihan email tidak memberikan atau mencabut persetujuan untuk mendebit dompet. Pesan sandbox diberi label. Tidak ada notifikasi untuk pembelian tertunda yang belum dibayar atau hadiah.", "operationId": "patch__api_v1_system_billing_notifications", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BillingNotificationSettingsInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/BillingNotificationSettings" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Konfigurasikan aturan email penagihan dan kontak dukungan publik", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/billing-notifications/preview": { "get": { "description": "Menggunakan pengaturan platform tersimpan dan data contoh sandbox. Tidak membuat pembelian atau job email.", "operationId": "get__api_v1_system_billing_notifications_preview", "parameters": [ { "in": "query", "name": "kind", "required": true, "schema": { "enum": [ "purchase_success", "expiry_reminder", "auto_renewal_success", "auto_renewal_problem" ], "type": "string" } }, { "in": "query", "name": "locale", "schema": { "default": "zh", "enum": [ "zh", "zh-hant", "en", "es", "hi", "ar", "fr", "bn", "pt", "id", "ur" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/BillingEmailPreview" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Pratinjau email penagihan tanpa mengirim", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/billing-notifications/test": { "post": { "description": "Uji eksplisit menggunakan data contoh sandbox, menambahkan [TEST], dan mengikuti konfigurasi email yang ada. Dapat menguji template meskipun jenis notifikasi pelanggan tersebut dinonaktifkan. Tidak ada pembayaran atau perpanjangan.", "operationId": "post__api_v1_system_billing_notifications_test", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BillingEmailTestInput" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/MailQueued" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Antrekan uji email penagihan yang diminta", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/check-mail": { "post": { "description": "Periksa hanya layanan yang tersimpan. Pemeriksaan penyedia API menggunakan permintaan hanya baca dan tidak pernah mengirim email. Kunci khusus pengiriman dapat menghasilkan check_status=limited dan ok=false; ini tidak mengonfirmasi kredensial valid atau pengiriman berhasil. Permintaan email uji eksplisit diperlukan untuk menguji pengiriman.", "operationId": "post_api_v1_system_check-mail", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/MailConnection" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "MAIL_PROVIDER_AUTH_FAILED, MAIL_PROVIDER_RATE_LIMITED atau MAIL_PROVIDER_UNAVAILABLE. Pengiriman email uji bersifat asinkron; kesalahan pengiriman muncul dalam hasil job, bukan respons HTTP 202 awal." } }, "security": [ { "session": [] } ], "summary": "post /system/check-mail", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/customer/cases": { "get": { "description": "", "operationId": "get__api_v1_system_customer_cases", "parameters": [ { "description": "Kecualikan satu jenis permintaan sebelum penghitungan dan paginasi. Gunakan refund untuk mengeluarkan kasus pengembalian dana dari daftar dukungan; akses tetap terbatas pada sesi saat ini.", "in": "query", "name": "exclude_kind", "schema": { "maxLength": 24, "type": "string" } }, { "description": "Batasi kasus pengembalian dana ke isi ulang dompet atau pembatalan layanan.", "in": "query", "name": "refund_scope", "required": false, "schema": { "enum": [ "wallet", "service" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportCaseList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Daftar permintaan pelanggan", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/customer/cases/unread": { "get": { "description": "Percakapan pengembalian dana dikecualikan. Pelanggan hanya melihat tiket ruang kerja yang diotorisasi; anggota melihat tiketnya sendiri. Setiap administrator memiliki penanda baca independen.", "operationId": "get__api_v1_system_customer_cases_unread", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportUnread" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca jumlah tiket pribadi dan pemberitahuan yang belum dibaca", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/customer/cases/{id}": { "get": { "description": "", "operationId": "get__api_v1_system_customer_cases__id_", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportCaseDetail" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca permintaan dan balasan", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/customer/cases/{id}/deletion-review": { "post": { "description": "Memerlukan pengakuan kewajiban keuangan. Segera mencabut akses normal; menutup ekspor pelanggan tepat setelah 30 hari dan mempertahankan semua catatan bisnis untuk ekspor administrator yang diotorisasi.", "operationId": "post__api_v1_system_customer_cases__id__deletion_review", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountClosureReview" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportCaseDetail" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Konfirmasi atau tolak penutupan logis akun", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/customer/cases/{id}/manual-refund": { "post": { "description": "Memerlukan persetujuan pelanggan dan bukti pembayaran selesai. Ini mencatat penyelesaian; tidak pernah mengirim transfer bank. Konfirmasi berulang tidak dapat mendebit dua kali. Pembayaran Waffo/Paddle asli, termasuk layanan, menolak jalur deklarasi saja ini dengan ORIGINAL_REFUND_REQUIRED.", "operationId": "post__api_v1_system_customer_cases__id__manual_refund", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManualRefundInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportCaseDetail" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Catat pengembalian alternatif yang benar-benar telah selesai", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/customer/cases/{id}/messages": { "post": { "description": "Kasus pengembalian dana menolak balasan dengan REFUND_REVIEW_WORKFLOW; administrator menyetujui atau menolak secara langsung. Tiket dukungan biasa tetap menerima balasan. Penutupan yang ditinjau mempertahankan status alur privasinya.", "operationId": "post__api_v1_system_customer_cases__id__messages", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportReply" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportCaseDetail" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Balas tiket dukungan", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/customer/cases/{id}/read": { "post": { "description": "Hanya pesan hingga pesan terakhir yang ditampilkan yang ditandai telah dibaca. Pesan yang datang kemudian tetap belum dibaca dan pengakuan tertunda tidak dapat menggeser penanda ke belakang.", "operationId": "post__api_v1_system_customer_cases__id__read", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportReadInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CommerceResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Akui pesan tiket yang ditampilkan", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/customer/cases/{id}/recover-original-refund": { "post": { "description": "Memerlukan konfirmasi eksplisit administrator bahwa tidak ada transfer alternatif yang benar-benar dilakukan. Mempertahankan bukti asli dan menggunakan entri ledger kompensasi. Hanya jumlah tersisa yang diminta dari pembayaran asli.", "operationId": "post__api_v1_system_customer_cases__id__recover_original_refund", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecoverOriginalRefund" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportCaseDetail" }, "request_id": { "format": "uuid", "type": "string" } }, "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" } }, "security": [ { "session": [] } ], "summary": "Koreksi deklarasi manual yang belum dibayar dan minta pengembalian asli", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/customer/cases/{id}/refund-quote": { "post": { "description": "Pratinjau cakupan, jumlah, dan jadwal terbaru. Cakupan layanan yang berubah memerlukan permohonan pelanggan baru; administrator dapat langsung menolak permohonan lama.", "operationId": "post__api_v1_system_customer_cases__id__refund_quote", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptyRefundPreviewInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ScopedRefundPreview" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Pratinjau permohonan bercakupan yang tertunda sebelum persetujuan", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/customer/cases/{id}/refund-review": { "post": { "description": "Diserialisasi berdasarkan ruang kerja target. Persetujuan mencadangkan dana dompet yang tersedia, mengalokasikan pengembalian melalui jalur asli menggunakan ID permintaan penyedia yang stabil, dan mempertahankan saldo yang memerlukan alternatif yang disepakati. Persetujuan Waffo/Paddle membuat intent pengembalian penyedia asli yang persisten dan mengirim permintaan API pengembalian pedagang. Deklarasi manual tidak dapat menyelesaikan pengembalian ini. Status persetujuan processing/pending bukan dana yang telah diselesaikan.", "operationId": "post__api_v1_system_customer_cases__id__refund_review", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RefundReview" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SupportCaseDetail" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Setujui atau tolak pengembalian dana pelanggan", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/legal/policy": { "get": { "description": "", "operationId": "get__api_v1_system_legal_policy", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CommercePolicy" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca profil operator dan versi kebijakan tertunda", "x-platform-admin": true, "x-required-role": "owner" }, "patch": { "description": "Publikasi memerlukan nama resmi operator yang telah dikonfirmasi dan email kontak yang valid. Detail profil lain bersifat opsional dan item yang belum dikonfirmasi dihilangkan dari dokumen publik. Penggantian yang diterbitkan mempertahankan versi sebelumnya selama setidaknya 30 hari pemberitahuan di konsol dan email yang berhasil dikirim.", "operationId": "patch__api_v1_system_legal_policy", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommercePolicyInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CommercePolicy" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Terbitkan atau jadwalkan kebijakan layanan", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/mail-jobs": { "get": { "description": "Hanya sesi platform-admin. 50 pesan terbaru beserta jenis, lingkungan, penerima, percobaan, status, dan alasan pembatalan. Payload yang dikirim/dibatalkan dihapus. Penerimaan SMTP bukan berarti pesan masuk ke kotak masuk atau dibaca.", "operationId": "get_api_v1_system_mail-jobs", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/MailJobList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "get /system/mail-jobs", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/mail-jobs/{id}/retry": { "post": { "description": "Mengatur ulang jumlah percobaan dan mengantrekan pesan gagal yang sama. Job yang terkirim, dibatalkan, berjalan, dan tertunda mengembalikan MAIL_JOB_NOT_RETRYABLE. Job penagihan memeriksa ulang persetujuan dan status peristiwa saat ini sebelum percobaan pengiriman baru. Kesalahan SMTP tidak pernah membatalkan pembayaran yang telah dikomit.", "operationId": "post__api_v1_system_mail_jobs__id__retry", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/MailQueued" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Coba ulang email gagal dengan payload terenkripsi yang dipertahankan", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/operations": { "get": { "description": "Hanya sesi platform-admin. Log aplikasi hanya tambah dengan pelaku, subjek, alasan, dan perubahan eksplisit.", "operationId": "get__api_v1_system_operations", "parameters": [ { "in": "query", "name": "limit", "schema": { "default": 25, "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "maximum": 100000, "minimum": 0, "type": "integer" } }, { "in": "query", "name": "user_id", "schema": { "format": "uuid", "type": "string" } }, { "in": "query", "name": "action", "schema": { "maxLength": 80, "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PlatformOperationList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Daftar operasi pelanggan administratif" } }, "/api/v1/system/overview": { "get": { "description": "Hanya sesi platform-admin. Metrik paket menggunakan lingkungan pembayaran yang dikonfigurasi saat ini. Pengguna baru mencakup 30 hari terakhir; kedaluwarsa mencakup 7 hari berikutnya.", "operationId": "get__api_v1_system_overview", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PlatformOverview" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca total pelanggan dan paket platform" } }, "/api/v1/system/paddle": { "get": { "operationId": "get__api_v1_system_paddle", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PaddleSettings" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca konfigurasi Paddle tanpa kunci privat", "x-licentivo-access": "platform" }, "patch": { "operationId": "patch__api_v1_system_paddle", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaddleSettingsInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PaddleSettings" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Simpan kredensial Paddle Billing terenkripsi", "x-licentivo-access": "platform" } }, "/api/v1/system/paddle/check": { "post": { "operationId": "post__api_v1_system_paddle_check", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PaddleCheck" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Verifikasi kredensial Paddle dan produk aktif", "x-licentivo-access": "platform" } }, "/api/v1/system/paddle/orders": { "get": { "operationId": "get__api_v1_system_paddle_orders", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PaddleOrderList" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Daftar pembayaran layanan Paddle dan isi ulang dompet", "x-licentivo-access": "platform" } }, "/api/v1/system/paddle/orders/{id}/reconcile": { "post": { "operationId": "post__api_v1_system_paddle_orders__id__reconcile", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaddleReconcileInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PaddleOrderResult" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Rekonsiliasi atau pulihkan transaksi asli tanpa membuat penagihan", "x-licentivo-access": "platform" } }, "/api/v1/system/payment-channels": { "get": { "operationId": "get__api_v1_system_payment_channels", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PaymentChannels" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Daftar kanal pembayaran yang dapat dikonfigurasi secara independen", "x-licentivo-access": "platform" }, "patch": { "operationId": "patch__api_v1_system_payment_channels", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentChannelInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PaymentChannels" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Aktifkan atau nonaktifkan kanal secara atomik dengan konkurensi optimistik", "x-licentivo-access": "platform" } }, "/api/v1/system/paypal": { "get": { "operationId": "get_api_v1_system_paypal", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PayPalSettings" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "paypal", "x-platform-admin": true, "x-required-role": "owner" }, "patch": { "operationId": "patch_api_v1_system_paypal", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PayPalInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PayPalSettings" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "paypal", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/paypal/check": { "post": { "operationId": "post_api_v1_system_paypal_check", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PayPalCheck" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "paypal/check", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/paypal/orders/{id}/refund": { "post": { "description": "Hanya sesi platform-admin. Mencadangkan kredit dompet tersedia yang belum dibelanjakan sebelum menghubungi PayPal. Pending berarti hasil belum dikonfirmasi; rekonsiliasi permintaan yang sama. Tidak otomatis membatalkan paket.", "operationId": "post__api_v1_system_paypal_orders__id__refund", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RefundInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PayPalRefund" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." } }, "security": [ { "session": [] } ], "summary": "Kembalikan dana dompet yang belum digunakan ke metode pembayaran PayPal semula" } }, "/api/v1/system/paypal/refund-requests": { "get": { "description": "Hanya sesi cookie; kunci API manajemen tidak diterima. Pembacaan pelanggan dibatasi ke ruang kerjanya. Penulisan pelanggan memerlukan Owner ruang kerja terverifikasi, tanpa izin administrator platform. Permohonan tidak memindahkan atau mencadangkan dana. Persetujuan administrator memeriksa ulang dompet saat ini dan nilai capture yang belum dikembalikan, lalu menggunakan alur pengembalian jalur asli dan reservasi idempoten yang ada. Persetujuan tidak membatalkan paket.", "operationId": "get__api_v1_system_paypal_refund_requests", "parameters": [ { "in": "query", "name": "mode", "schema": { "enum": [ "sandbox", "live" ], "type": "string" } }, { "in": "query", "name": "limit", "schema": { "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WalletRefundRequestList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" } }, "security": [ { "session": [] } ], "summary": "Daftar permohonan pengembalian dana pelanggan untuk ditinjau", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/paypal/refund-requests/{id}/review": { "post": { "description": "Hanya sesi cookie; kunci API manajemen tidak diterima. Pembacaan pelanggan dibatasi ke ruang kerjanya. Penulisan pelanggan memerlukan Owner ruang kerja terverifikasi, tanpa izin administrator platform. Permohonan tidak memindahkan atau mencadangkan dana. Persetujuan administrator memeriksa ulang dompet saat ini dan nilai capture yang belum dikembalikan, lalu menggunakan alur pengembalian jalur asli dan reservasi idempoten yang ada. Persetujuan tidak membatalkan paket.", "operationId": "post__api_v1_system_paypal_refund_requests__id__review", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WalletRefundReview" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WalletRefundRequest" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, autentikasi, kepemilikan, konflik peninjauan, atau saldo" } }, "security": [ { "session": [] } ], "summary": "Setujui atau tolak permohonan pengembalian dana pelanggan", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/paypal/refunds": { "get": { "description": "Hanya sesi platform-admin.", "operationId": "get__api_v1_system_paypal_refunds", "parameters": [ { "in": "query", "name": "limit", "schema": { "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "maximum": 100000, "minimum": 0, "type": "integer" } }, { "in": "query", "name": "mode", "schema": { "enum": [ "sandbox", "live" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/RefundList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." } }, "security": [ { "session": [] } ], "summary": "Daftar permintaan pengembalian dana untuk lingkungan pembayaran yang dipilih" } }, "/api/v1/system/paypal/refunds/{id}/reconcile": { "post": { "description": "Hanya sesi platform-admin. Mencoba ulang PayPal-Request-Id yang sama jika ID pengembalian dana belum diterima, atau mengambil pengembalian dana penyedia yang sudah ada.", "operationId": "post__api_v1_system_paypal_refunds__id__reconcile", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PayPalRefund" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." } }, "security": [ { "session": [] } ], "summary": "Rekonsiliasi pengembalian dana yang sama tanpa identitas penagihan baru" } }, "/api/v1/system/plan-gifts": { "get": { "description": "Hanya sesi platform-admin. Penerima yang diberikan mewakili ruang kerja yang telah dideduplikasi. Pencarian mencocokkan email penerima, ruang kerja, atau nama paket.", "operationId": "get__api_v1_system_plan_gifts", "parameters": [ { "in": "query", "name": "limit", "schema": { "default": 25, "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "maximum": 100000, "minimum": 0, "type": "integer" } }, { "in": "query", "name": "q", "schema": { "type": "string" } }, { "in": "query", "name": "mode", "schema": { "enum": [ "sandbox", "live" ], "type": "string" } }, { "in": "query", "name": "user_id", "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PlanGiftList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Daftar riwayat hadiah" }, "post": { "description": "Hanya sesi platform-admin. Batch atomik. Berikan fingerprint dari pratinjau dan request_id yang stabil; replay yang cocok mengembalikan batch yang sama. Perubahan tingkat atau jadwal memerlukan pratinjau baru. Hadiah mempertahankan pembayaran aktual nol dan tidak dapat menjadi pengembalian tunai. Nilai manfaat yang tercatat dikreditkan secara normal saat peningkatan. Hanya hadiah tingkat saat ini yang baru dan belum dimulai yang mengikuti peningkatan berikutnya tanpa pembayaran tambahan, dengan tanggal tetap. Hadiah historis tidak pernah diselaraskan ulang; kuota bulanan dan aturan kelebihan penggunaan berlaku normal. Batch campuran menggunakan metadata current/---; periksa catatan hadiah individual yang didukung pembelian untuk setiap tingkat dan mata uang aktual.", "operationId": "post__api_v1_system_plan_gifts", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlanGiftInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PlanGiftResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Konfirmasi hadiah tingkat saat ini yang telah ditinjau" } }, "/api/v1/system/plan-gifts/preview": { "post": { "description": "Hanya sesi platform-admin. 1–100 ID pengguna pelanggan aktif yang berbeda. Pengguna dalam ruang kerja yang sama menerima satu kontrak. Setiap item mewarisi paket efektif pelanggan saat ini, atau paket terakhir yang kedaluwarsa di lingkungan yang dipilih. Batch dengan tingkat campuran mengembalikan paket dan nilai manfaat aktual per item. Hilangkan plan/currency/price_version; nilai eksplisit opsional harus cocok dengan paket yang ada pada setiap pelanggan. Pelanggan tanpa paket tidak dapat menerima tingkat berbeda melalui endpoint ini. after_current menambahkan setelah seluruh cakupan berbayar/hadiah; immediate menolak hak yang tumpang tindih. Tanpa penulisan atau penagihan.", "operationId": "post__api_v1_system_plan_gifts_preview", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlanGiftPreviewInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PlanGiftPreview" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Pratinjau hadiah paket tingkat saat ini" } }, "/api/v1/system/plan-gifts/{id}/cancel": { "post": { "description": "Hanya sesi platform-admin. Pembatalan berulang aman. Menghentikan kontrak ini tanpa menghapus riwayat, mengembalikan biaya kelebihan penggunaan, atau memindahkan kontrak terjadwal lainnya.", "operationId": "post__api_v1_system_plan_gifts__id__cancel", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlatformReason" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PlanGiftCancellation" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Batalkan hadiah aktif atau terjadwal" } }, "/api/v1/system/plans": { "get": { "operationId": "get_api_v1_system_plans", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/AdminPlanList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "plans", "x-platform-admin": true, "x-required-role": "owner" }, "post": { "operationId": "post_api_v1_system_plans", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlanInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Price" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "plans", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/plans/customer-controls": { "patch": { "description": "Hanya sesi platform-admin. Kedua sakelar default false. Berikan device_enabled, api_enabled, atau keduanya. Sakelar yang tidak diberikan mempertahankan status saat ini. Setiap sakelar yang dinonaktifkan menyembunyikan kontrol pelanggan terkait dan mengabaikan hanya preferensi tersimpannya sendiri sampai diaktifkan kembali. Jatah API bertanda unlimited tetap tidak terbatas.", "operationId": "patch__api_v1_system_plans_customer_controls", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomerControlsInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CustomerControlsResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Izinkan pengaturan kelebihan perangkat atau API pelanggan secara independen" } }, "/api/v1/system/plans/default": { "patch": { "operationId": "patch_api_v1_system_plans_default", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DefaultPlan" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/DefaultPlan" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "plans/default", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/privacy/retention": { "get": { "description": "", "operationId": "get__api_v1_system_privacy_retention", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CommerceResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca pelaksanaan pengarsipan dan retensi", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/privacy/retention/run": { "post": { "description": "Hanya pengarsipan logis; baris pelanggan/bisnis dipertahankan. Merotasi file cadangan .lvb terkelola yang diautentikasi setelah 90 hari dan log keamanan milik aplikasi setelah enam bulan kalender. Pelaksanaan diserialisasi dengan kunci basis data.", "operationId": "post__api_v1_system_privacy_retention_run", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Confirmation" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/CommerceResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Proses pengarsipan dan retensi yang sudah jatuh tempo", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/provider-refunds/{id}/reconcile": { "post": { "description": "Memeriksa permintaan yang ada berdasarkan referensi penyedia/bisnisnya. Hanya intent persisten yang sebelumnya belum dikirim yang boleh mengirim permintaan pertamanya; pengiriman duplikat atau tidak diketahui tidak pernah dikirim lagi. Penyelesaian memerlukan tanda terima penyedia asli yang diverifikasi secara independen.", "operationId": "post__api_v1_system_provider_refunds__id__reconcile", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ProviderRefund" }, "request_id": { "format": "uuid", "type": "string" } }, "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" } }, "security": [ { "session": [] } ], "summary": "Rekonsiliasi pengembalian kanal asli yang sudah ada", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/refund-requests": { "get": { "description": "Sesi administrator platform hanya baca. Menggabungkan permohonan pengembalian dompet dan kasus pembatalan dompet/layanan penyedia. Jumlah tertunda yang dibatasi lingkungan terpisah dari filter paginasi dan cakupan. Pembacaan tidak pernah menyetujui, membekukan, atau mengembalikan dana; gunakan endpoint peninjauan yang ada pada masing-masing sumber.", "operationId": "get_system_refund_requests", "parameters": [ { "in": "query", "name": "mode", "schema": { "enum": [ "sandbox", "live" ], "type": "string" } }, { "in": "query", "name": "review", "schema": { "enum": [ "pending", "all" ], "type": "string" } }, { "in": "query", "name": "scope", "schema": { "enum": [ "wallet", "service" ], "type": "string" } }, { "in": "query", "name": "limit", "schema": { "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/RefundInboxList" }, "request_id": { "format": "uuid", "type": "string" } }, "type": "object" } } }, "description": "Permintaan dan jumlah peninjauan tertunda menurut lingkungan" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, sesi, atau izin" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, sesi, atau izin" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, sesi, atau izin" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, sesi, atau izin" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, sesi, atau izin" } }, "security": [ { "session": [] } ], "summary": "Antrean terpadu peninjauan pengembalian dana pelanggan", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/refunds": { "get": { "operationId": "get__api_v1_system_refunds", "parameters": [ { "in": "query", "name": "mode", "schema": { "enum": [ "sandbox", "live" ], "type": "string" } }, { "in": "query", "name": "limit", "schema": { "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/RefundHistory" }, "request_id": { "format": "uuid", "type": "string" } }, "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" } }, "security": [ { "session": [] } ], "summary": "Daftar pengembalian dana di PayPal, Waffo, dan Paddle", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/revenue": { "get": { "operationId": "get_api_v1_system_revenue", "parameters": [ { "in": "query", "name": "mode", "schema": { "enum": [ "sandbox", "live" ], "type": "string" } }, { "in": "query", "name": "month", "schema": { "description": "all atau UTC YYYY-MM", "type": "string" } }, { "in": "query", "name": "limit", "schema": { "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Revenue" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "revenue", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/sdk-example": { "post": { "description": "Hanya sesi Owner administrator platform, dengan CSRF. Kunci API ditolak. Menggunakan kembali produk dan kebijakan khusus; tidak memperpanjang uji coba yang sudah ada.", "operationId": "post_api_v1_system_sdk-example", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SDKExampleSetup" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SDKExampleSetting" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "Siapkan/aktifkan produk contoh SDK publik khusus milik administrator", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/service/incidents": { "get": { "description": "", "operationId": "get__api_v1_system_service_incidents", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ServiceIncidentList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca semua pemberitahuan layanan", "x-platform-admin": true, "x-required-role": "owner" }, "post": { "description": "Pemeliharaan non-darurat memerlukan pemberitahuan setidaknya 24 jam. Insiden berkelanjutan yang terverifikasi melebihi 24 jam mengkredit waktu berbayar yang benar-benar terdampak; interval yang tumpang tindih tidak dikompensasi dua kali. Lebih dari tujuh hari dapat memenuhi syarat pengembalian layanan yang belum digunakan.", "operationId": "post__api_v1_system_service_incidents", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceIncidentInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ServiceIncident" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Publikasikan pemeliharaan atau selesaikan insiden", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/settings": { "get": { "operationId": "get_api_v1_system_settings", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/SystemSettings" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "get /system/settings", "x-platform-admin": true, "x-required-role": "owner" }, "patch": { "operationId": "patch_api_v1_system_settings", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/MailSettings" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "patch /system/settings", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/test-mail": { "post": { "description": "Secara eksplisit antrekan satu pesan uji nyata ke penerima yang diberikan menggunakan layanan pengiriman tersimpan. HTTP 202 mengonfirmasi penerimaan antrean, bukan kedatangan di kotak masuk. Ikuti status job dan periksa dasbor penyedia/kotak masuk untuk masalah pengiriman.", "operationId": "post_api_v1_system_test-mail", "parameters": [ { "description": "Wajib untuk penulisan cookie/public-auth; pengecualian hanya untuk penulisan resource Bearer yang didukung", "in": "header", "name": "X-CSRF-Token", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TestMail" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/MailQueued" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] } ], "summary": "post /system/test-mail", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/tls": { "get": { "description": "Hanya sesi browser administrator platform. Kunci API manajemen dan owner tenant ditolak. Mencerminkan sertifikat yang digunakan proses ini. PEM sertifikat atau kunci privat tidak diungkap.", "operationId": "get__api_v1_system_tls", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/TLSStatus" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil; hanya metadata sertifikat publik yang dikembalikan." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code. TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED dan TLS_SETTINGS_CONFLICT mempertahankan sertifikat sebelumnya." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code. TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED dan TLS_SETTINGS_CONFLICT mempertahankan sertifikat sebelumnya." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code. TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED dan TLS_SETTINGS_CONFLICT mempertahankan sertifikat sebelumnya." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code. TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED dan TLS_SETTINGS_CONFLICT mempertahankan sertifikat sebelumnya." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code. TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED dan TLS_SETTINGS_CONFLICT mempertahankan sertifikat sebelumnya." } }, "security": [ { "session": [] } ], "summary": "Baca sertifikat HTTPS aktif" }, "patch": { "description": "Hanya sesi browser administrator platform. Kunci API manajemen dan owner tenant ditolak. Memvalidasi dan mengenkripsi sertifikat/kunci dalam MySQL, mencatat peristiwa audit, lalu mengganti sertifikat aktif. Handshake TLS baru segera menggunakannya; koneksi yang ada berlanjut seperti biasa. Setelah mulai ulang, sertifikat basis data lebih diutamakan daripada file bootstrap.", "operationId": "patch__api_v1_system_tls", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TLSCertificateUpdateInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/TLSCertificateResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil; hanya metadata sertifikat publik yang dikembalikan." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code. TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED dan TLS_SETTINGS_CONFLICT mempertahankan sertifikat sebelumnya." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code. TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED dan TLS_SETTINGS_CONFLICT mempertahankan sertifikat sebelumnya." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code. TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED dan TLS_SETTINGS_CONFLICT mempertahankan sertifikat sebelumnya." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code. TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED dan TLS_SETTINGS_CONFLICT mempertahankan sertifikat sebelumnya." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code. TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED dan TLS_SETTINGS_CONFLICT mempertahankan sertifikat sebelumnya." } }, "security": [ { "session": [] } ], "summary": "Ganti sertifikat HTTPS segera" } }, "/api/v1/system/tls/check": { "post": { "description": "Hanya sesi browser administrator platform. Kunci API manajemen dan owner tenant ditolak. Memeriksa format, kekuatan kunci, kecocokan kunci, hostname, masa berlaku, dan rantai kepercayaan. HTTPS langsung harus diaktifkan. Sertifikat aktif tidak berubah.", "operationId": "post__api_v1_system_tls_check", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TLSCertificateInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/TLSCertificateInfo" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil; hanya metadata sertifikat publik yang dikembalikan." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code. TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED dan TLS_SETTINGS_CONFLICT mempertahankan sertifikat sebelumnya." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code. TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED dan TLS_SETTINGS_CONFLICT mempertahankan sertifikat sebelumnya." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code. TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED dan TLS_SETTINGS_CONFLICT mempertahankan sertifikat sebelumnya." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code. TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED dan TLS_SETTINGS_CONFLICT mempertahankan sertifikat sebelumnya." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code. TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED dan TLS_SETTINGS_CONFLICT mempertahankan sertifikat sebelumnya." } }, "security": [ { "session": [] } ], "summary": "Validasi sertifikat dan kunci privat tanpa menyimpan" } }, "/api/v1/system/translation": { "get": { "description": "Hanya sesi platform-admin.", "operationId": "get__api_v1_system_translation", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/TranslationSettings" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." } }, "security": [ { "session": [] } ], "summary": "Baca pengaturan DeepL tanpa mengungkap kunci API" }, "patch": { "description": "Hanya sesi platform-admin. Gunakan expected_version dari GET terbaru. Kunci tidak pernah dikembalikan.", "operationId": "patch__api_v1_system_translation", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TranslationSettingsInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/TranslationSettings" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." } }, "security": [ { "session": [] } ], "summary": "Simpan pengaturan DeepL terenkripsi" } }, "/api/v1/system/translation/check": { "post": { "description": "Hanya memanggil endpoint bahasa dan penggunaan DeepL; tidak ada konten forum yang dikirim.", "operationId": "post__api_v1_system_translation_check", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/TranslationCheck" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat error.code dan error.message; request_id mengidentifikasi permintaan." } }, "security": [ { "session": [] } ], "summary": "Verifikasi kunci API tersimpan dan ambil bahasa yang didukung serta penggunaan" } }, "/api/v1/system/users": { "get": { "description": "Hanya sesi platform-admin. Mencakup akun yang belum diverifikasi dan anggota tim; tidak pernah mengembalikan hash atau token autentikasi.", "operationId": "get__api_v1_system_users", "parameters": [ { "description": "Pencocokan parsial email, nama, atau ruang kerja tanpa membedakan huruf besar/kecil; karakter wildcard di-escape.", "in": "query", "name": "q", "schema": { "maxLength": 254, "type": "string" } }, { "in": "query", "name": "status", "schema": { "enum": [ "active", "disabled" ], "type": "string" } }, { "in": "query", "name": "role", "schema": { "enum": [ "owner", "read_only" ], "type": "string" } }, { "in": "query", "name": "verified", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "in": "query", "name": "limit", "schema": { "default": 25, "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "maximum": 100000, "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PlatformUserList" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Daftar semua pengguna terdaftar" } }, "/api/v1/system/users/export.csv": { "get": { "description": "Hanya sesi platform-admin. Maksimum 10000 catatan cocok, UTF-8 BOM dan escaping rumus spreadsheet. Tanpa kredensial.", "operationId": "get__api_v1_system_users_export_csv", "parameters": [ { "description": "Pencocokan parsial email, nama, atau ruang kerja tanpa membedakan huruf besar/kecil; karakter wildcard di-escape.", "in": "query", "name": "q", "schema": { "maxLength": 254, "type": "string" } }, { "in": "query", "name": "status", "schema": { "enum": [ "active", "disabled" ], "type": "string" } }, { "in": "query", "name": "role", "schema": { "enum": [ "owner", "read_only" ], "type": "string" } }, { "in": "query", "name": "verified", "schema": { "enum": [ "true", "false" ], "type": "string" } } ], "responses": { "200": { "content": { "text/csv": { "schema": { "type": "string" } } }, "description": "Lampiran CSV" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Ekspor pengguna terdaftar yang difilter sebagai CSV" } }, "/api/v1/system/users/{id}": { "get": { "description": "Hanya sesi platform-admin. Saldo ruang kerja, 20 kontrak terbaru, dan total kumulatif PayPal yang dibayar/dikembalikan dipisahkan menurut mata uang dan lingkungan.", "operationId": "get__api_v1_system_users__id_", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PlatformUserDetail" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca detail pelanggan dan ruang kerja" }, "patch": { "description": "Hanya sesi platform-admin. Memerlukan alasan operasi dan versi optimistik. Penonaktifan mencabut sesi, kunci, dan tautan login yang ada. Pemulihan tidak memulihkan kunci. Akun administrator platform dilindungi.", "operationId": "patch__api_v1_system_users__id_", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlatformUserUpdate" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PlatformUserDetail" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Perbarui status pelanggan atau catatan admin privat" } }, "/api/v1/system/users/{id}/data-export": { "post": { "description": "Tersedia setelah penutupan akun dan setelah tenggat pelanggan. Memerlukan kata sandi administrator, cakupan, dan alasan operasional yang diaudit. Tidak ada catatan bisnis yang dihapus.", "operationId": "post__api_v1_system_users__id__data_export", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomerDataExportInput" } } }, "required": true }, "responses": { "200": { "content": { "application/zip": { "schema": { "format": "binary", "type": "string" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Ekspor catatan pelanggan yang dipertahankan", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/system/users/{id}/revoke-credentials": { "post": { "description": "Hanya sesi platform-admin. Tidak menonaktifkan akun; pelanggan dapat masuk kembali. Kredensial administrator tidak dapat dicabut di sini.", "operationId": "post__api_v1_system_users__id__revoke_credentials", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlatformReason" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PlatformRevocation" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Cabut sesi dan kunci API pelanggan yang ada" } }, "/api/v1/system/waffo": { "get": { "operationId": "get__api_v1_system_waffo", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WaffoSettings" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Baca pengaturan Waffo tanpa kunci penandatanganan", "x-licentivo-access": "platform" }, "patch": { "operationId": "patch__api_v1_system_waffo", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WaffoSettingsInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WaffoSettings" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Simpan kredensial Waffo terenkripsi", "x-licentivo-access": "platform" } }, "/api/v1/system/waffo/check": { "post": { "operationId": "post__api_v1_system_waffo_check", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WaffoCheck" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Verifikasi kredensial Waffo dan produk sekali bayar yang aktif", "x-licentivo-access": "platform" } }, "/api/v1/system/waffo/orders": { "get": { "operationId": "get__api_v1_system_waffo_orders", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WaffoOrderList" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Daftar pembayaran layanan Waffo dan isi ulang dompet", "x-licentivo-access": "platform" } }, "/api/v1/system/waffo/orders/{id}/reconcile": { "post": { "operationId": "post__api_v1_system_waffo_orders__id__reconcile", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/WaffoOrderResult" }, "request_id": { "description": "Pengenal pembayaran layanan lokal.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Pulihkan dan rekonsiliasi pembayaran Waffo asli", "x-licentivo-access": "platform" } }, "/api/v1/system/workspaces/{id}/status": { "patch": { "description": "Hanya sesi platform-admin. Penangguhan memblokir login, API manajemen, dan lisensi online, serta mencabut kredensial. Kedaluwarsa kontrak terus berjalan. Ruang kerja platform dilindungi; cache offline bertanda tangan tetap mengikuti kedaluwarsa yang berlaku.", "operationId": "patch__api_v1_system_workspaces__id__status", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlatformWorkspaceUpdate" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/PlatformWorkspaceStatus" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Periksa error.code dan error.message." } }, "security": [ { "session": [] } ], "summary": "Tangguhkan atau pulihkan seluruh ruang kerja pelanggan" } }, "/api/v1/system/{provider}/orders/{id}/refund": { "post": { "description": "Sesi administrator platform. Layanan berbayar memerlukan pembatalan sebagai gantinya. Pembayaran yang belum diterapkan dikembalikan tanpa pergerakan dompet. request_id yang stabil menyimpan intent secara persisten sebelum panggilan gateway; hasil yang tidak diketahui ditanyakan dan tidak pernah dikirim ulang secara membabi buta.", "operationId": "post__api_v1_system__provider__orders__id__refund", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "path", "name": "provider", "required": true, "schema": { "enum": [ "waffo", "paddle" ], "type": "string" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OriginalRefundInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/OriginalRefundResult" }, "request_id": { "format": "uuid", "type": "string" } }, "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Kesalahan validasi, kepemilikan, lingkungan, status pengembalian, atau penyedia" } }, "security": [ { "session": [] } ], "summary": "Mulai pengembalian melalui kanal asli untuk kredit yang belum dibelanjakan atau pembayaran yang belum diterapkan", "x-platform-admin": true, "x-required-role": "owner" } }, "/api/v1/usage": { "get": { "description": "Bulan saat ini melaporkan pendaftaran perangkat aktif; bulan lalu melaporkan riwayat penggunaan perangkat yang tercatat. Kuota API paket yang dibeli mengikuti bulan kuotanya sendiri. Riwayat perangkat dipertahankan setelah pelepasan. Hunian saat ini dan puncak penagihan adalah pengukuran yang terpisah.", "operationId": "get_api_v1_usage", "parameters": [ { "description": "Bulan kalender UTC; default bulan saat ini", "in": "query", "name": "month", "schema": { "description": "Bulan UTC YYYY-MM; nilai kueri yang dihilangkan menggunakan bulan saat ini. Job penagihan memerlukan bulan yang telah ditutup.", "pattern": "^[0-9]{4}-[0-9]{2}$", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "active_devices": 0, "api_calls": 0, "api_period": null, "billable_devices": 0, "estimated_total_cents": 0, "estimated_total_micros": 0, "month": "2026-09", "operations": [], "overage_devices": 0, "period": null, "products": [], "purchased": null, "purchased_active_devices": 0, "sandbox": false, "timezone": "UTC", "warning": "normal" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Usage", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "503": { "content": { "application/json": { "example": { "error": { "code": "DEFAULT_PLAN_DISABLED", "message": "The default allowance plan has not been enabled by the administrator" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Jatah default dinonaktifkan (DEFAULT_PLAN_DISABLED)" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Current device occupancy, historical device use and metered API usage", "x-management-reference": { "group": "usage" }, "x-required-scope": "read" } }, "/api/v1/usage/devices": { "get": { "description": "Catatan penggunaan perangkat untuk bulan UTC yang dipilih, dipertahankan setelah perangkat dilepas. Ini adalah riwayat aktivitas, bukan daftar perangkat online saat ini. Gunakan GET /api/v1/usage untuk hunian saat ini.", "operationId": "get_api_v1_usage_devices", "parameters": [ { "in": "query", "name": "limit", "schema": { "default": 25, "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "maximum": 100000, "minimum": 0, "type": "integer" } }, { "description": "Bulan kalender UTC; default bulan saat ini", "in": "query", "name": "month", "schema": { "description": "Bulan UTC YYYY-MM; nilai kueri yang dihilangkan menggunakan bulan saat ini. Job penagihan memerlukan bulan yang telah ditutup.", "pattern": "^[0-9]{4}-[0-9]{2}$", "type": "string" } }, { "in": "query", "name": "product_id", "schema": { "description": "UUID produk di ruang kerja saat ini.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": [ { "device_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "first_seen_at": "2026-09-01T00:00:00Z", "last_seen_at": "2026-09-30T00:00:00Z", "month": "2026-09", "product_id": "11111111-1111-4111-8111-111111111111" } ], "limit": 25, "offset": 0, "total": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/UsageDeviceList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar perangkat penggunaan", "x-management-reference": { "group": "usage" }, "x-required-scope": "read" } }, "/api/v1/usage/export.csv": { "get": { "description": "Catatan penggunaan perangkat untuk bulan UTC yang dipilih, dipertahankan setelah perangkat dilepas. Ini adalah riwayat aktivitas, bukan daftar perangkat online saat ini. Gunakan GET /api/v1/usage untuk hunian saat ini.", "operationId": "get_api_v1_usage_export_csv", "parameters": [ { "description": "Bulan kalender UTC; default bulan saat ini", "in": "query", "name": "month", "schema": { "description": "Bulan UTC YYYY-MM; nilai kueri yang dihilangkan menggunakan bulan saat ini. Job penagihan memerlukan bulan yang telah ditutup.", "pattern": "^[0-9]{4}-[0-9]{2}$", "type": "string" } } ], "responses": { "200": { "content": { "text/csv": { "example": "month,product_id,device_id,first_seen_utc,last_seen_utc\n", "schema": { "type": "string" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Ekspor penggunaan", "x-csv-columns": [ "month", "product_id", "device_id", "first_seen_utc", "last_seen_utc" ], "x-management-reference": { "group": "usage" }, "x-required-scope": "read" } }, "/api/v1/validate": { "post": { "description": "Diautentikasi dengan product_id + license_key + device_id. Tanpa cookie/CSRF/kunci vendor. activation_id wajib kecuali untuk activate. Setiap permintaan berhasil mengonsumsi satu panggilan API; replay idempoten dan kegagalan tidak. Kelebihan penggunaan mendebit dompet secara atomik atau mengembalikan API_QUOTA_EXCEEDED/API_BALANCE_INSUFFICIENT. Tanda terima percobaan ulang validasi dan heartbeat kedaluwarsa setelah 3600 detik. Selama otorisasi asli tetap valid, permintaan yang cocok dalam rentang ini diputar ulang tanpa debit tambahan. Setelah rentang tersebut gunakan kunci baru; kunci yang pernah digunakan dapat diproses sebagai permintaan baru. Tanda terima aktivasi, deaktivasi, dan penggunaan fitur tetap persisten. Kuota perangkat ruang kerja mengikuti aktivasi saat ini. Pelepasan mengembalikan kapasitas; kedaluwarsa lease floating juga mengembalikan kapasitas, sedangkan pendaftaran biasa yang offline tetap dihitung. Kelebihan perangkat hanya ditagih ketika puncak penagihan bulan kuota meningkat melampaui kapasitas yang sudah dibayar; pelepasan tidak mengembalikan biaya yang telah terjadi. Penggunaan API terpisah.", "operationId": "post_api_v1_validate", "parameters": [ { "description": "Buat kunci baru untuk setiap operasi; percobaan ulang mempertahankan kunci dan isi yang sama. Maksimum 80 karakter, tanpa spasi. Opsional untuk validasi dan heartbeat.", "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "maxLength": 80, "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RuntimeInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/RuntimeResult" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "Validasi runtime" } }, "/api/v1/webhook-deliveries/{id}/attempts": { "get": { "operationId": "get_api_v1_webhook-deliveries_by_id_attempts", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": null }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/AttemptList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar percobaan pengiriman", "x-management-reference": { "group": "webhooks" }, "x-required-scope": "read" } }, "/api/v1/webhook-deliveries/{id}/retry": { "post": { "operationId": "post_api_v1_webhook-deliveries_by_id_retry", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": {}, "schema": { "$ref": "#/components/schemas/Empty" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ID", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Coba ulang pengiriman webhook", "x-management-reference": { "group": "webhooks" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/webhooks": { "get": { "operationId": "get_api_v1_webhooks", "parameters": [], "responses": { "200": { "content": { "application/json": { "example": { "data": { "event_types": [], "items": [ { "created_at": "2026-10-18T00:00:00Z", "enabled": true, "events": [], "id": "33333333-3333-4333-8333-333333333333", "name": "Report app", "updated_at": "2026-10-18T00:00:00Z", "url": "https://merchant.example.com/license-events" } ] }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LicensingWebhookList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar webhook", "x-management-reference": { "group": "webhooks" }, "x-required-scope": "read" }, "post": { "operationId": "post_api_v1_webhooks", "parameters": [], "requestBody": { "content": { "application/json": { "example": { "enabled": true, "events": [ "license.created", "license.renewed" ], "name": "Order system", "url": "https://merchant.example.com/license-events" }, "schema": { "$ref": "#/components/schemas/LicensingWebhookInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "data": { "id": "33333333-3333-4333-8333-333333333333", "secret": "whsec_BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LicensingWebhookSecret", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Simpan webhook", "x-management-reference": { "group": "webhooks" }, "x-required-role": "owner", "x-required-scope": "write" } }, "/api/v1/webhooks/{id}/deliveries": { "get": { "operationId": "get_api_v1_webhooks_by_id_deliveries", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "description": "ID unik resource ini; gunakan ID resource yang sesuai dalam path.", "format": "uuid", "type": "string" } }, { "in": "query", "name": "limit", "schema": { "default": 25, "description": "Ukuran halaman, default 25, rentang 1–100.", "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offset", "schema": { "default": 0, "description": "Jumlah catatan yang dilewati, default 0, rentang 0–100000; tambahkan limit untuk halaman berikutnya.", "maximum": 100000, "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "example": { "data": { "items": null, "limit": 25, "offset": 0, "total": 1 }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/DeliveryList", "description": "Hasil bisnis jika berhasil; kegagalan menggunakan error sebagai gantinya." }, "request_id": { "description": "UUID jejak HTTP tingkat teratas. Dalam input batch/onboarding, ini adalah UUID idempotensi yang dibuat pemanggil; keduanya memiliki tujuan berbeda.", "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "example": { "error": { "code": "INVALID_INPUT", "message": "Invalid request fields" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "example": { "error": { "code": "UNAUTHENTICATED", "message": "Please sign in again" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "example": { "error": { "code": "FORBIDDEN", "message": "This operation requires an owner account" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "example": { "error": { "code": "NOT_FOUND", "message": "Resource not found" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "example": { "error": { "code": "METHOD_NOT_ALLOWED", "message": "Method not allowed" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "example": { "error": { "code": "CONFLICT", "message": "This value already exists" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "example": { "error": { "code": "JSON_REQUIRED", "message": "Use Content-Type: application/json" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "example": { "error": { "code": "RATE_LIMITED", "message": "Too many attempts; try again later" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "example": { "error": { "code": "INTERNAL_ERROR", "message": "An unexpected error occurred" }, "request_id": "55555555-5555-4555-8555-555555555555" }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [ { "session": [] }, { "managementKey": [] } ], "summary": "Daftar pengiriman webhook", "x-management-reference": { "group": "webhooks" }, "x-required-scope": "read" } }, "/healthz": { "get": { "operationId": "get_healthz", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Health" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" } }, "security": [], "summary": "Status hidup proses" } }, "/readyz": { "get": { "operationId": "get_readyz", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Health" }, "request_id": { "format": "uuid", "type": "string" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Berhasil" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "405": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Lihat docs/error-codes.md; penerapan spesifik endpoint" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Basis data tidak tersedia" } }, "security": [], "summary": "Kesiapan basis data" } } }, "servers": [ { "url": "https://www.licentivo.com" } ] }