Dokumentasi API

Pengantar

API GrowTech membuat aplikasi atau skrip Anda bisa mengurus proxy sendiri: melihat akun dan kuota, mengambil daftar proxy siap pakai, mengganti IP, sampai membeli GB.

Tiga langkah pertama

1. Buat kunci API (satu kunci per akun, perlu kode dari email): buka halaman Kunci API
2. Kirim kunci di setiap permintaan, di header Authorization: Bearer gtu_… (kunci Anda).
3. Coba perintah pertama di bawah. Ganti gtu_YOUR_KEY dengan kunci Anda.

Perintah pertama

curl -sS "https://www.growtechcentral.com/api/user/v1/me" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Kunci API & keamanan

Setiap endpoint, kecuali cek hidup /health, wajib memakai kunci API milik Anda sendiri.

Aturan penting

Hal-hal yang memengaruhi biaya dan hasil pemakaian Anda.

Batas pemakaian

Kalau terlewati, jawabannya 429 dengan header Retry-After (berapa detik harus menunggu).

• Semua panggilan60 per 1 menit
  Per pelanggan (= per kunci). Setiap jawaban membawa X-RateLimit-Limit dan X-RateLimit-Remaining.
• Per alamat IP60 per 1 menit
  Per alamat IP, dihitung sebelum kunci diperiksa.
• Baca kuota langsung10 per 1 menit
  POST /proxy-accounts/{id}/refresh, per akun.
• Ganti kata sandi5 per 1 menit
  Per akun; selain itu paling banyak 3 kali per akun dan 5 kali per pelanggan dalam 24 jam.
• Ubah daftar IP10 per 1 menit
  Menambah dan menghapus alamat, per pelanggan.
• Ubah situs yang diblokir12 per 1 menit
  PUT /proxy-accounts/{id}/blocked-hosts, per pelanggan.
• Daftar lokasi30 per 1 menit
  GET /locations/…, per pelanggan.
• Daftar proxy30 per 1 menit
  GET /proxy-accounts/{id}/proxy-list, per pelanggan.
• Ganti IP10 per 1 menit
  POST /proxy-accounts/{id}/rotate-ip, per akun.
• Pembelian10 per 1 menit
  POST /orders, per pelanggan (tanpa batas harian).

Kode galat

Kalau permintaan ditolak, jawabannya berisi error.code yang bisa dibaca program Anda.

• unauthorizedHTTP 401
  Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• insufficient_balanceHTTP 402
  Saldo dompet tidak cukup untuk pembelian; tidak ada yang ditagih (details: saldo, kebutuhan, kekurangan).
• feature_disabledHTTP 403
  GrowTech sedang mematikan pembelian lewat API; belilah di website.
• insufficient_scopeHTTP 403
  Hanya untuk kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas: kunci itu tidak punya akses yang dibutuhkan panggilan ini (required_scope menyebutnya). Buat ulang kunci — kunci baru bisa semuanya.
• ip_not_allowedHTTP 403
  Kunci ini dibatasi ke alamat IP lain (daftar IP-nya di website).
• purchase_not_allowedHTTP 403
  Kunci ini tidak boleh membeli: nyalakan "Izinkan beli GB" untuk kunci ini di website (Akun → Kunci API). Tidak ada yang ditagih.
• not_foundHTTP 404
  Akun proxy tidak ada, atau bukan milik Anda.
• product_not_foundHTTP 404
  Produk tidak dikenal atau tidak tersedia; details.available berisi produk yang dijual.
• product_not_on_accountHTTP 404
  Akun ini tidak memiliki produk itu (?product=).
• idempotency_conflictHTTP 409
  Idempotency-Key sudah dipakai untuk pembelian lain.
• not_readyHTTP 409
  Akun masih disiapkan. Coba lagi semenit lagi.
• request_in_progressHTTP 409
  Pembelian dengan Idempotency-Key ini masih berjalan; ulangi sesudah Retry-After.
• reset_in_progressHTTP 409
  Penggantian kata sandi akun ini sedang berjalan.
• idempotency_key_invalidHTTP 422
  Idempotency-Key harus 1 sampai 64 huruf, angka, atau . _ - :
• idempotency_key_requiredHTTP 422
  Pembelian membutuhkan header Idempotency-Key.
• invalid_ipHTTP 422
  Hanya alamat IPv4 publik yang bisa diizinkan.
• invalid_rangeHTTP 422
  Rentang pemakaian salah: tanggal tidak sah, from sesudah to, atau lebih dari 92 hari.
• not_supportedHTTP 422
  Produk ini tidak menyediakan pengaturan atau pilihan tersebut (details.control); lihat features produknya.
• request_refusedHTTP 422
  Jaringan proxy menolak permintaan ini (misalnya alamat yang sudah dipakai di tempat lain). Mengulang panggilan yang sama tidak akan membantu.
• single_country_requiredHTTP 422
  Residential Plus menampilkan provinsi dan kota untuk satu negara per panggilan.
• subaccount_not_provisionedHTTP 422
  Akun belum siap untuk ini. Coba lagi semenit lagi.
• validation_failedHTTP 422
  Ada parameter yang kurang atau salah; fields menyebut masing-masing.
• whitelist_limit_reachedHTTP 422
  Daftar IP sudah penuh (limits.whitelist_max); hapus satu alamat dulu.
• rate_limitedHTTP 429
  Terlalu banyak panggilan; tunggu Retry-After detik.
• reset_limit_account_reachedHTTP 429
  Akun ini sudah 3 kali ganti kata sandi dalam 24 jam terakhir.
• reset_limit_user_reachedHTTP 429
  Anda sudah 5 kali ganti kata sandi dalam 24 jam terakhir.
• api_disabledHTTP 503
  API sedang dimatikan untuk perawatan. Coba lagi nanti.
• purchases_pausedHTTP 503
  Pembelian sedang dijeda di website; coba lagi nanti.
• refresh_failedHTTP 503
  Kuota terbaru tidak terbaca. Coba lagi sebentar lagi.
• temporarily_unavailableHTTP 503
  Jaringan proxy tidak menjawab tepat waktu. Coba lagi sebentar lagi.

Akun, dompet, dan kuota Anda

Panggilan paling ringan untuk menguji kunci: akun pemilik kunci, saldo dompet utama dalam IDR, total kuota proxy dari semua akun Anda, kunci itu sendiri (awalannya, batas IP-nya, dan apakah kunci boleh membeli GB: purchase_allowed), serta batas per menit Anda.

Parameter

Tanpa parameter.

Contoh permintaan

curl -sS "https://www.growtechcentral.com/api/user/v1/me" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Contoh jawaban

{
  "data": {
    "user": {
      "id": 501,
      "name": "Budi Santoso",
      "email": "[email protected]",
      "wallet_balance_idr": 250000
    },
    "quota": {
      "purchased_mb": 10240,
      "allocated_mb": 10240,
      "used_mb": 3072,
      "available_mb": 7168,
      "purchased_gb": 10,
      "allocated_gb": 10,
      "used_gb": 3,
      "available_gb": 7,
      "accounts": 2
    },
    "api_key": {
      "prefix": "gtu_Ab3x",
      "scopes": [
        "*"
      ],
      "allowed_ips": [],
      "purchase_allowed": false,
      "last_used_at": "2026-10-22T02:15:00+00:00"
    },
    "rate_limit": {
      "per_minute": 60
    }
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Produk dan harga Anda

Semua produk yang dijual beserta harga per GB untuk Anda (potongan Anda sudah dihitung), tangga harga per volume, batas jumlah pesanan, dan kemampuan produk. Periksa features sebelum memanggil sebuah pengaturan: produk yang tidak memilikinya menjawab not_supported.

Parameter

Tanpa parameter.

Contoh permintaan

curl -sS "https://www.growtechcentral.com/api/user/v1/products" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Contoh jawaban

{
  "data": [
    {
      "slug": "residential",
      "name": "Residential",
      "price_per_gb_idr": 15000,
      "min_gb": 1,
      "max_gb": 10240,
      "price_steps": [
        {
          "min_gb": 1,
          "price_per_gb_idr": 15000
        },
        {
          "min_gb": 10,
          "price_per_gb_idr": 14000
        }
      ],
      "features": {
        "targeting": {
          "country": true,
          "state": true,
          "city": true,
          "asn": true,
          "zip": false
        },
        "targeting_cost_multiplier": {
          "state": 2,
          "city": 2,
          "asn": 2
        },
        "sticky_sessions": true,
        "protocols": [
          "http",
          "https",
          "socks5"
        ],
        "ip_whitelist": true,
        "blocked_hosts": true,
        "password_reset": true
      },
      "limits": {
        "whitelist_max": 5
      }
    },
    {
      "slug": "residential-plus",
      "name": "Residential Plus",
      "price_per_gb_idr": 18000,
      "min_gb": 1,
      "max_gb": 10240,
      "price_steps": [
        {
          "min_gb": 1,
          "price_per_gb_idr": 18000
        }
      ],
      "features": {
        "targeting": {
          "country": true,
          "state": true,
          "city": true,
          "asn": false,
          "zip": false
        },
        "targeting_cost_multiplier": {},
        "sticky_sessions": true,
        "protocols": [
          "http",
          "socks5"
        ],
        "ip_whitelist": true,
        "blocked_hosts": false,
        "password_reset": false
      },
      "limits": {
        "whitelist_max": null
      }
    }
  ]
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Harga untuk sejumlah GB

Harga persis yang Anda bayar saat ini untuk gb GB sebuah produk: harga per GB, potongan, pajak, dan total dalam IDR. Harganya sama dengan di website.

Parameter

• productwajibdi query
  Slug produknya.
• gbintegerwajibdi query
  Berapa GB, 1 sampai 10240.

Contoh permintaan

curl -sS "https://www.growtechcentral.com/api/user/v1/quote?product=residential&gb=10" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Contoh jawaban

{
  "data": {
    "product": {
      "slug": "residential",
      "name": "Residential"
    },
    "gb": 10,
    "price_per_gb_idr": 14000,
    "subtotal_idr": 140000,
    "discount_percent": 0,
    "discount_idr": 0,
    "tax_percent": 0,
    "tax_idr": 0,
    "total_idr": 140000,
    "min_gb": 1,
    "max_gb": 10240
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 404Produk tidak dikenal atau tidak tersedia; details.available berisi produk yang dijual.
• 422Ada parameter yang kurang atau salah; fields menyebut masing-masing.
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Negara yang bisa dituju sebuah produk

Kode negara (ISO 3166-1 alpha-2, huruf kecil) beserta jumlah alamat IP jika diketahui. count bernilai null jika tidak diketahui; counts_available menunjukkan apakah jumlahnya terbaca dan as_of kapan. Pakai kodenya untuk penargetan negara.

Parameter

• productwajibdi query
  Slug produknya.

Contoh permintaan

curl -sS "https://www.growtechcentral.com/api/user/v1/locations/countries?product=residential" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Contoh jawaban

{
  "data": {
    "product": {
      "slug": "residential",
      "name": "Residential"
    },
    "countries": [
      {
        "code": "us",
        "name": "United States",
        "count": 1152000
      },
      {
        "code": "id",
        "name": "Indonesia",
        "count": 96000
      }
    ],
    "counts_available": true,
    "as_of": "2026-10-22T01:00:00+00:00"
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 404Produk tidak dikenal atau tidak tersedia; details.available berisi produk yang dijual.
• 422Ada parameter yang kurang atau salah; fields menyebut masing-masing.
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Provinsi, kota, atau jaringan di sebuah negara

Provinsi/negara bagian, kota, atau jaringan (ASN) yang bisa dituju sebuah produk di negara yang Anda sebut. available: false berarti produk itu tidak bisa menargetkan tingkat tersebut (misalnya ASN pada Residential Plus) dan daftarnya kosong. Residential Plus menerima tepat satu negara per panggilan.

Parameter

• dimensionstring (states | cities | asns)wajibdi alamat
  Daftar yang diminta: states, cities, atau asns.
• productwajibdi query
  Slug produknya.
• countrystringwajibdi query
  Satu atau beberapa kode negara, dipisah koma (us atau us,de).
• qstringopsionaldi query
  Hanya entri yang kode atau namanya mengandung teks ini.
• limitintegeropsionaldi query
  Paling banyak sejumlah ini, 1 sampai 500 (bawaan 200). truncated menunjukkan apakah masih ada lagi.

Contoh permintaan

curl -sS "https://www.growtechcentral.com/api/user/v1/locations/states?product=residential&country=us" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Contoh jawaban

{
  "data": {
    "product": {
      "slug": "residential",
      "name": "Residential"
    },
    "dimension": "states",
    "countries": [
      "us"
    ],
    "available": true,
    "options": [
      {
        "code": "california",
        "name": "California",
        "count": 48000
      },
      {
        "code": "texas",
        "name": "Texas",
        "count": 36000
      }
    ],
    "total": 51,
    "truncated": false,
    "counts_available": true,
    "as_of": "2026-10-22T01:00:00+00:00"
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 404Produk tidak dikenal atau tidak tersedia; details.available berisi produk yang dijual.
• 422Ada parameter yang salah, atau Residential Plus menerima lebih dari satu negara (single_country_required).
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Akun proxy Anda

Semua akun proxy beserta produk, status, kuota, kemampuan, dan batasnya, sesuai urutan dibuat. Kuota diperbarui di latar belakang; quota.updated_at menunjukkan kapan terakhir dibaca.

Parameter

• productopsionaldi query
  Hanya akun yang memiliki produk ini.
• statusstring (active | depleted | suspended | provisioning | unavailable)opsionaldi query
  Hanya akun dengan status ini.
• pageintegeropsionaldi query
  Nomor halaman, mulai 1.
• per_pageintegeropsionaldi query
  Jumlah akun per halaman, 1 sampai 200 (bawaan 50).

Contoh permintaan

curl -sS "https://www.growtechcentral.com/api/user/v1/proxy-accounts" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Contoh jawaban

{
  "data": [
    {
      "id": 1024,
      "product": {
        "slug": "residential",
        "name": "Residential"
      },
      "products": [
        {
          "slug": "residential",
          "name": "Residential"
        }
      ],
      "status": "active",
      "quota": {
        "total_mb": 10240,
        "used_mb": 3072,
        "remaining_mb": 7168,
        "updated_at": "2026-10-22T02:10:00+00:00"
      },
      "features": {
        "targeting": {
          "country": true,
          "state": true,
          "city": true,
          "asn": true,
          "zip": false,
          "exclude_country": true
        },
        "targeting_cost_multiplier": {
          "state": 2,
          "city": 2,
          "asn": 2
        },
        "sticky_sessions": true,
        "protocols": [
          "http",
          "https",
          "socks5"
        ],
        "ip_whitelist": true,
        "blocked_hosts": true,
        "password_reset": true
      },
      "limits": {
        "whitelist_max": 5,
        "credential_resets_left_today": 3
      },
      "created_at": "2026-10-01T08:00:00+00:00"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 50,
    "total": 1,
    "last_page": 1
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 422Ada parameter yang kurang atau salah; fields menyebut masing-masing.
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Satu akun proxy

Isinya sama dengan satu entri pada daftar.

Parameter

• idintegerwajibdi alamat
  Id akun proxy (dari GET /proxy-accounts).

Contoh permintaan

curl -sS "https://www.growtechcentral.com/api/user/v1/proxy-accounts/1024" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Contoh jawaban

{
  "data": {
    "id": 1024,
    "product": {
      "slug": "residential",
      "name": "Residential"
    },
    "products": [
      {
        "slug": "residential",
        "name": "Residential"
      }
    ],
    "status": "active",
    "quota": {
      "total_mb": 10240,
      "used_mb": 3072,
      "remaining_mb": 7168,
      "updated_at": "2026-10-22T02:10:00+00:00"
    },
    "features": {
      "targeting": {
        "country": true,
        "state": true,
        "city": true,
        "asn": true,
        "zip": false,
        "exclude_country": true
      },
      "targeting_cost_multiplier": {
        "state": 2,
        "city": 2,
        "asn": 2
      },
      "sticky_sessions": true,
      "protocols": [
        "http",
        "https",
        "socks5"
      ],
      "ip_whitelist": true,
      "blocked_hosts": true,
      "password_reset": true
    },
    "limits": {
      "whitelist_max": 5,
      "credential_resets_left_today": 3
    },
    "created_at": "2026-10-01T08:00:00+00:00"
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 404Akun proxy tidak ada atau bukan milik Anda (not_found); atau akun itu tidak memiliki produk tersebut (product_not_on_account).
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Baca kuota terbaru sekarang

Membaca kuota akun ini secara langsung. 200: terbaca sekarang. 202 dengan Retry-After: pembacaan diantrekan; panggil GET /proxy-accounts/{id} sesudah menunggu. 503 refresh_failed: coba lagi nanti. Paling banyak 10 kali per menit per akun; daftar akun sudah diperbarui di latar belakang, jadi panggilan ini jarang diperlukan.

Parameter

• idintegerwajibdi alamat
  Id akun proxy (dari GET /proxy-accounts).
• productopsionaldi query
  Untuk akun yang memiliki lebih dari satu produk: produk yang mana. Tanpa ini, produk pertama akun itu.

Contoh permintaan

curl -sS -X POST "https://www.growtechcentral.com/api/user/v1/proxy-accounts/1024/refresh" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Contoh jawaban

{
  "data": {
    "account": {
      "id": 1024,
      "product": {
        "slug": "residential",
        "name": "Residential"
      },
      "products": [
        {
          "slug": "residential",
          "name": "Residential"
        }
      ],
      "status": "active",
      "quota": {
        "total_mb": 10240,
        "used_mb": 3072,
        "remaining_mb": 7168,
        "updated_at": "2026-10-22T02:10:00+00:00"
      },
      "features": {
        "targeting": {
          "country": true,
          "state": true,
          "city": true,
          "asn": true,
          "zip": false,
          "exclude_country": true
        },
        "targeting_cost_multiplier": {
          "state": 2,
          "city": 2,
          "asn": 2
        },
        "sticky_sessions": true,
        "protocols": [
          "http",
          "https",
          "socks5"
        ],
        "ip_whitelist": true,
        "blocked_hosts": true,
        "password_reset": true
      },
      "limits": {
        "whitelist_max": 5,
        "credential_resets_left_today": 3
      },
      "created_at": "2026-10-01T08:00:00+00:00"
    },
    "refreshed": true,
    "pending": false
  }
}

Jawaban lain

• 202Diantrekan: baca akunnya lagi sesudah Retry-After detik.
• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 404Akun proxy tidak ada atau bukan milik Anda (not_found); atau akun itu tidak memiliki produk tersebut (product_not_on_account).
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503Kuota tidak terbaca (refresh_failed), atau API sedang dimatikan.

Trafik terpakai dari waktu ke waktu

Trafik yang terpakai, dari catatan kami sendiri: satu titik per hari atau per jam (UTC) yang ada trafiknya, beserta totalnya. Rentang paling panjang 92 hari; tanpa tanggal, 7 hari terakhir. Jam tanpa trafik tidak ditampilkan.

Parameter

• idintegerwajibdi alamat
  Id akun proxy (dari GET /proxy-accounts).
• fromstringopsionaldi query
  Hari pertama, YYYY-MM-DD (UTC).
• tostringopsionaldi query
  Hari terakhir, YYYY-MM-DD (UTC).
• intervalstring (day | hour)opsionaldi query
  day (bawaan) atau hour.
• productopsionaldi query
  Untuk akun yang memiliki lebih dari satu produk: produk yang mana. Tanpa ini, produk pertama akun itu.

Contoh permintaan

curl -sS "https://www.growtechcentral.com/api/user/v1/proxy-accounts/1024/usage" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Contoh jawaban

{
  "data": {
    "from": "2026-10-16",
    "to": "2026-10-22",
    "interval": "day",
    "points": [
      {
        "at": "2026-10-21",
        "used_mb": 512.5
      },
      {
        "at": "2026-10-22",
        "used_mb": 128
      }
    ],
    "totals": {
      "used_mb": 640.5,
      "days": 7,
      "avg_mb_per_day": 91.5,
      "peak_hour": {
        "at": "2026-10-21T14:00:00+00:00",
        "used_mb": 96.25
      }
    }
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 404Akun proxy tidak ada atau bukan milik Anda (not_found); atau akun itu tidak memiliki produk tersebut (product_not_on_account).
• 422Tanggal salah, from sesudah to, atau rentang lebih dari 92 hari (invalid_range).
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Host, port, username, dan kata sandi

Isian untuk perangkat lunak Anda, beserta connection_string yang siap pakai. ports.rotating: alamat baru di setiap permintaan. ports.sticky: rentang port yang masing-masing memegang satu alamat (bawaan 30 menit). Residential Plus: tiap port di ports.sticky adalah alamatnya sendiri, dipegang selama rotasi IP yang disetel untuk akun itu di website; kata sandinya membawa penargetan dalam bentuk wifi;<negara>;<wilayah>;<kota>; (kosong = di mana saja). Jawabannya memuat kata sandi asli: simpan jawaban ini, dan kunci Anda, dengan aman.

Parameter

• idintegerwajibdi alamat
  Id akun proxy (dari GET /proxy-accounts).
• productopsionaldi query
  Untuk akun yang memiliki lebih dari satu produk: produk yang mana. Tanpa ini, produk pertama akun itu.

Contoh permintaan

curl -sS "https://www.growtechcentral.com/api/user/v1/proxy-accounts/1024/connection" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Contoh jawaban

{
  "data": {
    "account_id": 1024,
    "product": {
      "slug": "residential",
      "name": "Residential"
    },
    "host": "proxy.growtechcentral.com",
    "username": "a1b2c3d4e5",
    "password": "Pw7x9k2LmQ",
    "ports": {
      "rotating": {
        "http": 823,
        "socks5": 824
      },
      "sticky": {
        "from": 10000,
        "to": 29999
      }
    },
    "protocols": [
      "http",
      "https",
      "socks5"
    ],
    "connection_string": "http://a1b2c3d4e5:[email protected]:823"
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 404Akun proxy tidak ada atau bukan milik Anda (not_found); atau akun itu tidak memiliki produk tersebut (product_not_on_account).
• 409Akun masih disiapkan. Coba lagi semenit lagi.
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Daftar proxy siap pakai

Sampai 1000 baris dalam format pilihan Anda, dengan penargetan sudah di dalamnya. session=rotating (bawaan): semua baris sama, alamat baru di setiap permintaan. session=sticky: satu port per baris, tiap port memegang alamatnya (produk utama: bawaan 30 menit; Residential Plus: selama rotasi IP yang disetel untuk akun itu di website). Penargetan yang tidak bisa dilakukan produk ditolak dengan not_supported dan details.control menyebutnya; ttl (lama sesi) belum tersedia. cost_multiplier dan note memberi tahu bila penargetan provinsi, kota, atau ASN membuat trafik memakai kuota lebih cepat. Barisnya memuat kata sandi asli: simpan dengan aman.

Parameter

• idintegerwajibdi alamat
  Id akun proxy (dari GET /proxy-accounts).
• productopsionaldi query
  Untuk akun yang memiliki lebih dari satu produk: produk yang mana. Tanpa ini, produk pertama akun itu.
• countrystringopsionaldi query
  Kode negara (ISO 3166-1 alpha-2). Wajib sebelum state, city, atau asn.
• statestringopsionaldi query
  Kode provinsi/negara bagian dari GET /locations/states.
• citystringopsionaldi query
  Kode kota dari GET /locations/cities.
• asnintegeropsionaldi query
  Nomor jaringan dari GET /locations/asns.
• sessionstring (rotating | sticky)opsionaldi query
  rotating (bawaan) atau sticky.
• protocolstring (http | socks5)opsionaldi query
  http (bawaan) atau socks5. Di produk utama, baris rotating SOCKS5 memakai port tersendiri; port sticky melayani keduanya.
• countintegeropsionaldi query
  Berapa baris, 1 sampai 1000 (bawaan 1).
• formatstring (host:port:user:pass | user:pass@host:port | user:pass:host:port | host:port@user:pass | url | host:port)opsionaldi query
  Format baris (bawaan host:port:user:pass). url memberi http://user:pass@host:port atau socks5://…; host:port untuk alamat yang ada di daftar IP yang diizinkan akun itu.
• ttlintegeropsionaldi query
  Lama sesi. Belum tersedia: menjawab not_supported.

Contoh permintaan

curl -sS "https://www.growtechcentral.com/api/user/v1/proxy-accounts/1024/proxy-list" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Contoh jawaban

{
  "data": {
    "account_id": 1024,
    "product": {
      "slug": "residential",
      "name": "Residential"
    },
    "session": "sticky",
    "protocol": "http",
    "format": "host:port:user:pass",
    "targeting": {
      "country": "us",
      "state": "california",
      "city": null,
      "asn": null
    },
    "cost_multiplier": 2,
    "note": "State, city or ASN targeting on Residential uses quota at 2 times the normal rate: 1 GB of traffic counts as 2 GB.",
    "count": 2,
    "lines": [
      "proxy.growtechcentral.com:10000:a1b2c3d4e5__cr.us;state.california:Pw7x9k2LmQ",
      "proxy.growtechcentral.com:10001:a1b2c3d4e5__cr.us;state.california:Pw7x9k2LmQ"
    ]
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 404Akun proxy tidak ada atau bukan milik Anda (not_found); atau akun itu tidak memiliki produk tersebut (product_not_on_account).
• 409Akun masih disiapkan. Coba lagi semenit lagi.
• 422Ada parameter yang salah (validation_failed), atau produk tidak bisa melakukan yang diminta (not_supported; details.control berisi country, state, city, asn, sticky_sessions, atau ttl).
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Ganti IP

Satu panggilan untuk alamat baru di setiap produk. Produk utama (method: new_session): menjawab detail koneksi baru dengan sesi baru di port sticky; pakai itu menggantikan yang lama (country, state, city, asn opsional di body menjaga penargetan Anda). Residential Plus (method: session_reset): port yang Anda sebut (ports, atau semua port bila dikosongkan) mendapat alamat baru; detail koneksi Anda tetap sama. Port rotating sudah memberi alamat baru di setiap permintaan. Paling banyak 10 kali per menit per akun.

Parameter

• idintegerwajibdi alamat
  Id akun proxy (dari GET /proxy-accounts).
• productopsionaldi query
  Untuk akun yang memiliki lebih dari satu produk: produk yang mana. Tanpa ini, produk pertama akun itu.

Isi permintaan (JSON)

Produk utama: penargetan opsional. Residential Plus: ports opsional (9000–18999, paling banyak 64).

{
  "country": "us"
}

Contoh permintaan

curl -sS -X POST "https://www.growtechcentral.com/api/user/v1/proxy-accounts/1024/rotate-ip" \
  -H "Authorization: Bearer gtu_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"us"}'

Contoh jawaban

{
  "data": {
    "account_id": 1024,
    "product": {
      "slug": "residential",
      "name": "Residential"
    },
    "method": "new_session",
    "session_id": "3f9a1c7b2e04",
    "connection": {
      "host": "proxy.growtechcentral.com",
      "port": 10000,
      "username": "a1b2c3d4e5__cr.us;sessid.3f9a1c7b2e04",
      "password": "Pw7x9k2LmQ",
      "connection_string": "http://a1b2c3d4e5__cr.us;sessid.3f9a1c7b2e04:[email protected]:10000"
    },
    "cost_multiplier": 1,
    "note": null,
    "at": "2026-10-22T12:30:00+00:00"
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 404Akun proxy tidak ada atau bukan milik Anda (not_found); atau akun itu tidak memiliki produk tersebut (product_not_on_account).
• 409Akun masih disiapkan. Coba lagi semenit lagi.
• 422Ada parameter yang salah (validation_failed), atau tidak berlaku untuk produknya (not_supported: ports di produk utama, penargetan di Residential Plus).
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Username dan kata sandi baru

Mengganti username dan kata sandi akun; pasangan lama langsung berhenti bekerja. Jawabannya berisi detail koneksi yang baru. Paling banyak 3 kali per akun dan 5 kali per pelanggan dalam 24 jam (resets_left_today). Tidak tersedia di Residential Plus (not_supported).

Parameter

• idintegerwajibdi alamat
  Id akun proxy (dari GET /proxy-accounts).
• productopsionaldi query
  Untuk akun yang memiliki lebih dari satu produk: produk yang mana. Tanpa ini, produk pertama akun itu.

Contoh permintaan

curl -sS -X POST "https://www.growtechcentral.com/api/user/v1/proxy-accounts/1024/credentials/reset" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Contoh jawaban

{
  "data": {
    "account_id": 1024,
    "product": {
      "slug": "residential",
      "name": "Residential"
    },
    "host": "proxy.growtechcentral.com",
    "username": "f6g7h8i9j0",
    "password": "Nq4r8s1TzW",
    "ports": {
      "rotating": {
        "http": 823,
        "socks5": 824
      },
      "sticky": {
        "from": 10000,
        "to": 29999
      }
    },
    "protocols": [
      "http",
      "https",
      "socks5"
    ],
    "connection_string": "http://f6g7h8i9j0:[email protected]:823",
    "resets_left_today": 2
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 404Akun proxy tidak ada atau bukan milik Anda (not_found); atau akun itu tidak memiliki produk tersebut (product_not_on_account).
• 409Akun masih disiapkan (not_ready), atau penggantian sedang berjalan (reset_in_progress).
• 422Produk ini tidak menyediakan pengaturan tersebut (details.control); lihat features produknya.
• 429Terlalu banyak panggilan (rate_limited), atau batas penggantian harian tercapai (reset_limit_account_reached, reset_limit_user_reached).
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Alamat IP yang diizinkan tanpa kata sandi

Alamat yang boleh memakai akun ini tanpa username dan kata sandi, serta berapa yang muat (max_ips, null jika produk tidak menetapkan batas).

Parameter

• idintegerwajibdi alamat
  Id akun proxy (dari GET /proxy-accounts).
• productopsionaldi query
  Untuk akun yang memiliki lebih dari satu produk: produk yang mana. Tanpa ini, produk pertama akun itu.

Contoh permintaan

curl -sS "https://www.growtechcentral.com/api/user/v1/proxy-accounts/1024/whitelist" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Contoh jawaban

{
  "data": {
    "account_id": 1024,
    "product": {
      "slug": "residential",
      "name": "Residential"
    },
    "ips": [
      "203.0.113.7",
      "203.0.113.9"
    ],
    "max_ips": 5
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 404Akun proxy tidak ada atau bukan milik Anda (not_found); atau akun itu tidak memiliki produk tersebut (product_not_on_account).
• 409Akun masih disiapkan. Coba lagi semenit lagi.
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Izinkan sebuah alamat IP

Menambah satu alamat IPv4 publik. Menjawab 201 dengan seluruh daftar. Daftar yang penuh menjawab whitelist_limit_reached; hapus satu alamat dulu.

Parameter

• idintegerwajibdi alamat
  Id akun proxy (dari GET /proxy-accounts).
• productopsionaldi query
  Untuk akun yang memiliki lebih dari satu produk: produk yang mana. Tanpa ini, produk pertama akun itu.

Isi permintaan (JSON)

Alamat yang diizinkan.

{
  "ip": "203.0.113.9"
}

Contoh permintaan

curl -sS -X POST "https://www.growtechcentral.com/api/user/v1/proxy-accounts/1024/whitelist" \
  -H "Authorization: Bearer gtu_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ip":"203.0.113.9"}'

Contoh jawaban

{
  "data": {
    "account_id": 1024,
    "product": {
      "slug": "residential",
      "name": "Residential"
    },
    "ips": [
      "203.0.113.7",
      "203.0.113.9"
    ],
    "max_ips": 5
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 404Akun proxy tidak ada atau bukan milik Anda (not_found); atau akun itu tidak memiliki produk tersebut (product_not_on_account).
• 409Akun masih disiapkan. Coba lagi semenit lagi.
• 422Bukan alamat IPv4 publik (invalid_ip), daftar sudah penuh (whitelist_limit_reached), atau jaringan proxy menolak alamat itu (request_refused, misalnya sudah dipakai di tempat lain).
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Hapus alamat IP yang diizinkan

Menghapus satu alamat, dikirim sebagai {"ip": …} di body atau sebagai ?ip=. Jawabannya berisi daftar yang tersisa.

Parameter

• idintegerwajibdi alamat
  Id akun proxy (dari GET /proxy-accounts).
• productopsionaldi query
  Untuk akun yang memiliki lebih dari satu produk: produk yang mana. Tanpa ini, produk pertama akun itu.
• ipstringopsionaldi query
  Alamat yang dihapus (pengganti body).

Isi permintaan (JSON)

Alamat yang dihapus.

{
  "ip": "203.0.113.9"
}

Contoh permintaan

curl -sS -X DELETE "https://www.growtechcentral.com/api/user/v1/proxy-accounts/1024/whitelist" \
  -H "Authorization: Bearer gtu_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ip":"203.0.113.9"}'

Contoh jawaban

{
  "data": {
    "account_id": 1024,
    "product": {
      "slug": "residential",
      "name": "Residential"
    },
    "ips": [
      "203.0.113.7",
      "203.0.113.9"
    ],
    "max_ips": 5
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 404Akun proxy tidak ada atau bukan milik Anda (not_found); atau akun itu tidak memiliki produk tersebut (product_not_on_account).
• 409Akun masih disiapkan. Coba lagi semenit lagi.
• 422Ada parameter yang kurang atau salah; fields menyebut masing-masing.
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Situs yang tidak bisa dibuka akun ini

Nama domain yang diblokir untuk akun ini. Tidak tersedia di Residential Plus (not_supported).

Parameter

• idintegerwajibdi alamat
  Id akun proxy (dari GET /proxy-accounts).
• productopsionaldi query
  Untuk akun yang memiliki lebih dari satu produk: produk yang mana. Tanpa ini, produk pertama akun itu.

Contoh permintaan

curl -sS "https://www.growtechcentral.com/api/user/v1/proxy-accounts/1024/blocked-hosts" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Contoh jawaban

{
  "data": {
    "account_id": 1024,
    "product": {
      "slug": "residential",
      "name": "Residential"
    },
    "hosts": [
      "ads.example.com",
      "tracker.example.net"
    ]
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 404Akun proxy tidak ada atau bukan milik Anda (not_found); atau akun itu tidak memiliki produk tersebut (product_not_on_account).
• 409Akun masih disiapkan. Coba lagi semenit lagi.
• 422Produk ini tidak menyediakan pengaturan tersebut (details.control); lihat features produknya.
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Ganti daftar situs yang diblokir

Mengganti seluruh daftar dengan yang Anda kirim: paling banyak 100 nama domain; [] mengosongkannya. Tidak tersedia di Residential Plus (not_supported).

Parameter

• idintegerwajibdi alamat
  Id akun proxy (dari GET /proxy-accounts).
• productopsionaldi query
  Untuk akun yang memiliki lebih dari satu produk: produk yang mana. Tanpa ini, produk pertama akun itu.

Isi permintaan (JSON)

Daftar baru secara lengkap.

{
  "hosts": [
    "ads.example.com",
    "tracker.example.net"
  ]
}

Contoh permintaan

curl -sS -X PUT "https://www.growtechcentral.com/api/user/v1/proxy-accounts/1024/blocked-hosts" \
  -H "Authorization: Bearer gtu_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hosts":["ads.example.com","tracker.example.net"]}'

Contoh jawaban

{
  "data": {
    "account_id": 1024,
    "product": {
      "slug": "residential",
      "name": "Residential"
    },
    "hosts": [
      "ads.example.com",
      "tracker.example.net"
    ]
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 404Akun proxy tidak ada atau bukan milik Anda (not_found); atau akun itu tidak memiliki produk tersebut (product_not_on_account).
• 409Akun masih disiapkan. Coba lagi semenit lagi.
• 422Ada host yang bukan nama domain (validation_failed, fields menyebutnya sebagai hosts.N), atau produk tidak bisa memblokir situs (not_supported).
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Pembelian GB Anda

Pembelian GB proxy Anda, yang terbaru di atas. status: pending dan processing (sedang diproses), completed (GB sudah masuk ke akun), failed (terhenti; tim kami memeriksanya), cancelled (terhenti sebelum ada GB yang ditambahkan).

Parameter

• pageintegeropsionaldi query
  Nomor halaman, mulai 1.
• per_pageintegeropsionaldi query
  Jumlah pesanan per halaman, 10 sampai 50 (bawaan 20).

Contoh permintaan

curl -sS "https://www.growtechcentral.com/api/user/v1/orders" \
  -H "Authorization: Bearer gtu_YOUR_KEY"

Contoh jawaban

{
  "data": [
    {
      "id": 881,
      "order_id": 5521,
      "product": {
        "slug": "residential",
        "name": "Residential"
      },
      "gb": 10,
      "price_idr": 140000,
      "status": "completed",
      "applied_at": "2026-10-20T03:00:12+00:00",
      "failed_at": null,
      "created_at": "2026-10-20T02:59:40+00:00"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 1,
    "last_page": 1
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 403Kunci ini dibatasi ke alamat IP lain (ip_not_allowed). Kunci yang dibuat sebelum 23 Okt 2026 dengan akses terbatas juga bisa mendapat insufficient_scope: buat ulang kunci untuk akses penuh.
• 422Ada parameter yang kurang atau salah; fields menyebut masing-masing.
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503API sedang dimatikan untuk perawatan (api_disabled), atau jaringan proxy tidak menjawab tepat waktu (temporarily_unavailable). Coba lagi nanti.

Beli GB dengan dompet Anda

Membeli gb GB sebuah produk dengan saldo dompet Anda, dengan harga website, persis seperti website: pesanan yang sama, potongan dompet yang sama, isi ulang akun proxy yang sama. Hanya berjalan dengan kunci yang saklar "Izinkan beli GB"-nya menyala (Akun → Kunci API di website; awalnya mati, dan bisa Anda nyalakan atau matikan kapan saja): bila tidak, dijawab 403 purchase_not_allowed dan tidak ada yang ditagih. Selama GrowTech mematikan pembelian lewat API, setiap panggilan menjawab 403 feature_disabled; sementara itu belilah di website. Tanpa account_id, GB masuk ke tempat yang sama dengan pembelian produk itu di website; dengan account_id, ke akun proxy tersebut. Header Idempotency-Key wajib, satu nilai baru untuk setiap pembelian: mengulang dengan Idempotency-Key dan isi yang sama tidak akan membeli dua kali dan menjawab hasil pertama lagi (header Idempotent-Replayed: true); Idempotency-Key yang sama dengan isi lain menjawab 409 idempotency_conflict; selama permintaan pertama masih berjalan, 409 request_in_progress. Setiap Idempotency-Key diingat selama 30 hari. Saldo dompet yang kurang menjawab 402 insufficient_balance: isi saldo di website, lalu beli lagi dengan Idempotency-Key baru.

Parameter

• Idempotency-Keystringwajibdi header
  Satu nilai baru untuk setiap pembelian: 1 sampai 64 huruf, angka, atau . _ - :. Pakai ulang hanya untuk mengulang pembelian yang sama.

Isi permintaan (JSON)

Apa yang dibeli.

{
  "product": "residential",
  "gb": 10
}

Contoh permintaan

curl -sS -X POST "https://www.growtechcentral.com/api/user/v1/orders" \
  -H "Authorization: Bearer gtu_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product":"residential","gb":10}'

Contoh jawaban

{
  "data": {
    "id": 882,
    "order_id": 5522,
    "invoice": "INV-20261022-ABCD1234",
    "product": {
      "slug": "residential",
      "name": "Residential"
    },
    "gb": 10,
    "account_id": null,
    "status": "pending",
    "paid": true,
    "amount": {
      "subtotal_idr": 140000,
      "tax_idr": 0,
      "total_idr": 140000
    },
    "wallet_balance_idr": 110000,
    "created_at": "2026-10-22T13:05:00+00:00"
  }
}

Jawaban lain

• 401Kunci API tidak dikirim, salah, sudah dimatikan, atau sudah diganti.
• 402Saldo dompet tidak cukup (insufficient_balance). Tidak ada yang ditagih.
• 403Saklar "Izinkan beli GB" pada kunci ini mati (purchase_not_allowed), atau GrowTech sedang mematikan pembelian lewat API (feature_disabled). Tidak ada yang ditagih.
• 404Produk tidak dikenal (product_not_found), akun yang bukan milik Anda (not_found), atau akun yang tidak bisa menerima produk itu (product_not_on_account).
• 409Kunci sudah dipakai untuk pembelian lain (idempotency_conflict), atau permintaan dengan kunci itu masih berjalan (request_in_progress, ulangi sesudah Retry-After).
• 422Idempotency-Key tidak dikirim atau salah bentuk (idempotency_key_required, idempotency_key_invalid), atau isi permintaan salah (validation_failed).
• 429Terlalu banyak panggilan. Tunggu Retry-After detik.
• 503Pembelian sedang dijeda di website (purchases_paused), atau API sedang dimatikan untuk perawatan (api_disabled).

Apakah API berjalan

Tanpa kunci. Menjawab {"status":"ok"} selama layanan berjalan, juga ketika API sedang dimatikan untuk perawatan; untuk menguji kunci Anda, panggil GET /me.

Parameter

Tanpa parameter.

Contoh permintaan

curl -sS "https://www.growtechcentral.com/api/user/v1/health"

Contoh jawaban

{
  "status": "ok"
}

Jawaban lain

• 429Terlalu banyak panggilan. Tunggu Retry-After detik.