Perpanjang dengan saldo

POST/account/api/v1/renewals/create

Konfirmasikan operasi dengan sengaja

Operasi ini dapat mengubah catatan, saldo, atau pengaturan layanan. Baca cakupan dan catatan terlebih dahulu. Jika hasil tidak pasti, periksa operasi yang sama, jangan memulai yang baru.

Otorisasi

Authorization	`Bearer YOUR_ARNPROXY_API_KEY`
Izin yang diperlukan	`renewals`
Accept	`application/json`
Content-Type	`application/json`
Idempotency-Key	16–100 huruf, angka, _ atau -. Simpan dan gunakan nilai yang sama untuk operasi yang sama.

Parameter

Nama	Tipe	Keterangan
`Idempotency-Key` headerWajib	`string`	16–100 huruf/angka/_/-. Pertahankan nilai untuk operasi/status; jangan pakai lagi dengan isi berbeda.
`proxy_ids` bodyWajib	`integer[]`	1–1000 ID proxy unik milik sendiri; jangan campur tipe produk saat perlu cakupan/harga bersama. Beberapa operasi lebih ketat.
`time_id` bodyWajib	`integer`	ID periode/paket GB dari katalog/options terkait, bukan jumlah hari/GB.
`promo_code` bodyOpsional	`string`	Promo opsional, maksimal 100 byte. Pertahankan sama antara harga dan pembelian/perpanjangan. Nilai bawaan: `""`
`currency` bodyWajib	`string`	TRY atau USD dari kutipan harga yang sama; harus cocok dengan mata uang akun.
`expected_total_minor` bodyWajib	`integer`	total_minor dari harga yang sama sebagai integer, bukan nominal desimal atau string. 1–999999999999.
`expected_days` bodyWajib	`integer`	days dari harga yang sama; 1–36500.
`expected_selection_hash` bodyWajib	`string`	selection_hash dari harga yang sama: 64 karakter heksadesimal kecil.
`terms` bodyWajib	`boolean`	Persetujuan harus berupa boolean JSON true, bukan string "true".

Isi permintaan

Ganti YOUR_/FROM_ dengan nilai katalog, kutipan harga, atau cakupan terkait. Persetujuan pada contoh tetap false; setujui operasi nyata secara sengaja.

request.json

{
    "proxy_ids": [
        "YOUR_PROXY_ID"
    ],
    "time_id": "FROM_RENEWAL_OPTIONS",
    "promo_code": "",
    "currency": "FROM_QUOTE",
    "expected_total_minor": "FROM_QUOTE_TOTAL_MINOR",
    "expected_days": "FROM_QUOTE_DAYS",
    "expected_selection_hash": "FROM_QUOTE_SELECTION_HASH",
    "terms": false
}

Contoh permintaan

cURL

printf 'Authorization: Bearer %s\n' "$ARNPROXY_API_KEY" |
  curl --silent --show-error --header @- \
    --header 'Accept: application/json' \
    --connect-timeout 10 --max-time 30 \
    --header 'Idempotency-Key: YOUR_SAVED_OPERATION_KEY' \
    --request POST --header 'Content-Type: application/json' \
    --data-binary @request.json \
    'https://www.arnproxy.com/account/api/v1/renewals/create'

Contoh tidak dijalankan di halaman ini. Simpan kunci API dalam variabel lingkungan server, bukan URL atau kode browser. Siapkan request.json untuk contoh POST.

Respons

201Respons berhasil

application/json

{
    "ok": true,
    "data": {
        "state": "completed",
        "currency": "TRY",
        "total": "10.00",
        "total_minor": 1000,
        "renewal_batch_id": 100,
        "renewal_request_ids": [
            101
        ],
        "days": 7,
        "proxies": [
            {
                "id": 12345,
                "previous_last_service_date": "2030-02-01",
                "last_service_date": "2030-02-08",
                "total": "10.00"
            }
        ],
        "completed_at": "2030-01-01T12:00:00+00:00",
        "automatic_renewal": false,
        "source": "existing_website_renewal",
        "replayed": false
    },
    "meta": {
        "request_id": "000000000000000000000001",
        "phase": "public_v1",
        "source": "arnproxy_records"
    }
}

Kolom dan tipe respons

Nama	Tipe	Keterangan
`ok`	`boolean`	Penanda berhasil; jika false, periksa error.code.
`data`	`object`	Hasil khusus operasi; contoh bersifat ilustratif dan sintetis.
`data.state`	`string`	Status catatan/operasi. accepted bukan terkirim; completed bukan tes koneksi.
`data.currency`	`string`	Mata uang transaksi akun: TRY atau USD.
`data.total`	`string`	Nominal uang; pertahankan representasi string/integer untuk presisi.
`data.total_minor`	`integer`	Integer satuan uang terkecil: 1000 berarti 10.00 TRY/USD.
`data.renewal_batch_id`	`integer`	Nilai khusus operasi untuk renewal batch id. Pertahankan tipe yang dikembalikan dan baca catatan perilaku.
`data.renewal_request_ids`	`array`	Nilai khusus operasi untuk renewal request ids. Pertahankan tipe yang dikembalikan dan baca catatan perilaku.
`data.renewal_request_ids[]`	`integer`	Nilai khusus operasi untuk renewal request ids. Pertahankan tipe yang dikembalikan dan baca catatan perilaku.
`data.days`	`integer`	Durasi paket dalam hari, terpisah dari jumlah trafik paket GB.
`data.proxies`	`array`	Nilai khusus operasi untuk proxies. Pertahankan tipe yang dikembalikan dan baca catatan perilaku.
`data.proxies[]`	`object`	Nilai khusus operasi untuk proxies. Pertahankan tipe yang dikembalikan dan baca catatan perilaku.
`data.proxies[].id`	`integer`	ID catatan ARNPROXY terkait; gunakan alih-alih ID internal penyedia.
`data.proxies[].previous_last_service_date`	`string`	Hari layanan terakhir: saat ini, sebelumnya, atau proyeksi harga. Proyeksi tidak memperpanjang.
`data.proxies[].last_service_date`	`string`	Hari layanan terakhir: saat ini, sebelumnya, atau proyeksi harga. Proyeksi tidak memperpanjang.
`data.proxies[].total`	`string`	Nominal uang; pertahankan representasi string/integer untuk presisi.
`data.completed_at`	`string`	Stempel waktu sesuai representasi API; tanggal contoh sintetis.
`data.automatic_renewal`	`boolean`	Nilai khusus operasi untuk automatic renewal. Pertahankan tipe yang dikembalikan dan baca catatan perilaku.
`data.source`	`string`	Sumber data; catatan lokal dan kueri penyedia langsung merupakan bukti berbeda.
`data.replayed`	`boolean`	Hasil tersimpan dari operasi sama, bukan bukti debit/tindakan baru.
`meta`	`object`	Metadata korelasi permintaan dan sumber data.
`meta.request_id`	`string`	ID korelasi permintaan HTTP ini, bukan kunci operasi atau ID pesanan.
`meta.phase`	`string`	Nilai khusus operasi untuk phase. Pertahankan tipe yang dikembalikan dan baca catatan perilaku.
`meta.source`	`string`	Sumber data; catatan lokal dan kueri penyedia langsung merupakan bukti berbeda.

Respons kesalahan

HTTP 401 · INVALID_API_KEY

{
  "ok": false,
  "error": { "code": "INVALID_API_KEY" },
  "meta": { "request_id": "000000000000000000000001" }
}

Autentikasi dan validasi dapat menolak permintaan sebelum dijalankan. Lihat referensi kesalahan dan simpan request_id untuk dukungan. Jangan kirim kunci atau kata sandi. Kesalahan & batas →

Perilaku & catatan penting

Perpanjangan memakai harga dan saldo situs yang ada. Salin nominal, hari, dan hash pilihan dari renewal_quote yang sama. Tidak mengaktifkan perpanjangan otomatis.
Timeout/5xx bukan bukti perubahan gagal. Gunakan Idempotency-Key awal untuk status. Jangan ulang dengan kunci baru; GET tidak mengirim ulang perubahan.
Proxy dalam satu permintaan perpanjangan harus memiliki jenis produk yang sama. Diskon dihitung per negara berdasarkan jumlah yang dipilih, bukan gabungan semua negara.

Lacak operasi yang samaStatus perpanjangan →