ARNPROXY

Lanjutkan langkah IP belum dikirim

POST/account/api/v1/proxies/access/resume
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

AuthorizationBearer YOUR_ARNPROXY_API_KEY
Izin yang diperlukanproxy_management
Acceptapplication/json
Content-Typeapplication/json
Idempotency-Key16–100 huruf, angka, _ atau -. Simpan dan gunakan nilai yang sama untuk operasi yang sama.

Parameter

NamaTipeKeterangan
Idempotency-Key
headerWajib
string16–100 huruf/angka/_/-. Pertahankan nilai untuk operasi/status; jangan pakai lagi dengan isi berbeda.
terms
bodyWajib
booleanPersetujuan 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
{
    "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/proxies/access/resume'

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

200Respons berhasil
application/json
{
    "ok": true,
    "data": {
        "state": "completed",
        "action": "ip_add",
        "proxy_ids": [
            12345
        ],
        "reason_code": null,
        "replayed": true,
        "provider_write_steps_sent": 1,
        "resume_available": false,
        "primary_credentials_locked": true,
        "credentials_returned": false,
        "balance_changed": false,
        "proxy_expiry_changed": false,
        "authorization_scope": "upstream_order",
        "shared_order_effects_accepted": true,
        "grant_state": "active"
    },
    "meta": {
        "request_id": "000000000000000000000001",
        "phase": "public_v1",
        "source": "arnproxy_records"
    }
}
Kolom dan tipe respons
NamaTipeKeterangan
okbooleanPenanda berhasil; jika false, periksa error.code.
dataobjectHasil khusus operasi; contoh bersifat ilustratif dan sintetis.
data.statestringStatus catatan/operasi. accepted bukan terkirim; completed bukan tes koneksi.
data.actionstringNilai khusus operasi untuk action. Pertahankan tipe yang dikembalikan dan baca catatan perilaku.
data.proxy_idsarrayID proxy dalam cakupan yang terlihat bagi akun ini.
data.proxy_ids[]integerID proxy dalam cakupan yang terlihat bagi akun ini.
data.reason_codestring|nullKode alasan tetap atau null, bukan teks kesalahan penyedia mentah.
data.replayedbooleanHasil tersimpan dari operasi sama, bukan bukti debit/tindakan baru.
data.provider_write_steps_sentintegerNilai khusus operasi untuk provider write steps sent. Pertahankan tipe yang dikembalikan dan baca catatan perilaku.
data.resume_availablebooleanIzin melanjutkan langkah belum dikirim; jangan ulang otomatis jika false.
data.primary_credentials_lockedbooleanNilai khusus operasi untuk primary credentials locked. Pertahankan tipe yang dikembalikan dan baca catatan perilaku.
data.credentials_returnedbooleanNilai khusus operasi untuk credentials returned. Pertahankan tipe yang dikembalikan dan baca catatan perilaku.
data.balance_changedbooleanDampak yang dilaporkan; pengaturan perpanjangan otomatis dapat menimbulkan debit terpisah kelak.
data.proxy_expiry_changedbooleanDampak yang dilaporkan; pengaturan perpanjangan otomatis dapat menimbulkan debit terpisah kelak.
data.authorization_scopestringCakupan otorisasi; operasi pesanan/paket dapat memengaruhi penetapan lain.
data.shared_order_effects_acceptedbooleanNilai khusus operasi untuk shared order effects accepted. Pertahankan tipe yang dikembalikan dan baca catatan perilaku.
data.grant_statestringStatus pemberian IP. Penghapusan dapat memiliki grant_state=none; pemberian induk dicabut terpisah.
metaobjectMetadata korelasi permintaan dan sumber data.
meta.request_idstringID korelasi permintaan HTTP ini, bukan kunci operasi atau ID pesanan.
meta.phasestringNilai khusus operasi untuk phase. Pertahankan tipe yang dikembalikan dan baca catatan perilaku.
meta.sourcestringSumber 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

  • Timeout/5xx bukan bukti perubahan gagal. Gunakan Idempotency-Key awal untuk status. Jangan ulang dengan kunci baru; GET tidak mengirim ulang perubahan.
  • Perubahan kredensial utama lama tidak dapat dilanjutkan dan memberi 403. Hanya langkah IP belum dikirim yang ada boleh dilanjutkan dengan persetujuan. Periksa status memakai kunci sama; langkah terkirim tidak dikirim ulang.
Lacak operasi yang samaPeriksa operasi akses →

Cari dalam bahasa saat ini. Tutup dengan Esc