localization
Sokongan berbilang bahasa dan geo-lokasi dengan penyamaran zon waktu dan pengepala Accept-Language. Sesuai untuk perangkakan antarabangsa, memintas sekatan geo dan mengakses kandungan serantau.
Kes Penggunaan
Perangkakan Antarabangsa
Akses kandungan khusus serantau daripada pelbagai negara dengan penyetempatan yang betul
Kandungan Disekat Geo
Pintas sekatan geo dan akses kandungan yang terhad kepada wilayah tertentu
Penetapan Harga Serantau
Bandingkan harga merentas negara berbeza untuk tapak e-dagang dan pelancongan
Tapak Berbilang Bahasa
Rangka kandungan dalam bahasa berbeza dengan pengepala Accept-Language yang betul
Carian Setempat
Dapatkan hasil carian sebagaimana ia kelihatan kepada pengguna di negara tertentu
Penyelidikan Pasaran
Analisis cara kandungan, harga dan ketersediaan berbeza merentas wilayah
Endpoint
/api/v1/tools/localizationParameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
operation | string | Required | - | Operasi penyetempatan: "configure_country", "localize_search", "localize_browser", atau "handle_geo_blocking" Example: localize_browser |
countryCode | string | Required | - | Kod negara ISO 3166-1 dua huruf (cth., US, GB, JP) Example: JP |
language | string | Optional | - | Kod bahasa ISO 639-1 dua huruf (cth., en, es, ja) Example: ja |
geoLocation | object | Optional | - | Koordinat GPS untuk penyamaran geo-lokasi Example: {"latitude": 35.6762, "longitude": 139.6503} |
timezone | string | Optional | - | Pengecam zon waktu IANA (cth., America/New_York, Asia/Tokyo) Example: Asia/Tokyo |
url | string | Optional | - | URL sasaran untuk dirangka dengan tetapan penyetempatan Example: https://example.com |
Operasi yang Tersedia
Contoh Permintaan
Contoh Respons
{ "success": true, "data": { "localizedContent": "ja\">...", "detectedLanguage": "ja", "countryCode": "JP", "timezone": "Asia/Tokyo", "geoLocation": { "latitude": 35.6762, "longitude": 139.6503, "city": "Tokyo", "region": "Tokyo", "country": "Japan" }, "headers": { "Accept-Language": "ja-JP,ja;q=0.9", "Accept-Encoding": "gzip, deflate, br", "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" }, "regionSpecificData": { "currency": "JPY", "currencySymbol": "¥", "dateFormat": "YYYY/MM/DD", "timeFormat": "24h" } }, "credits_used": 2, "credits_remaining": 998, "processing_time": 1850}data.localizedContentKandungan halaman sebagaimana ia kelihatan kepada pengguna di negara yang ditentukandata.detectedLanguageBahasa yang dikesan daripada kandungan (ISO 639-1)data.countryCodeKod negara yang digunakan untuk penyetempatandata.geoLocationButiran geo-lokasi termasuk bandar dan wilayahdata.headersPengepala HTTP yang dihantar dengan tetapan penyetempatandata.regionSpecificDataPemformatan khusus serantau tambahan (mata wang, tarikh)credits_usedCredits ditolak untuk permintaan ini (2 setiap penyetempatan)Pengendalian Ralat
Kod Negara Tidak Sah (400 Bad Request)
Kod negara bukan kod ISO 3166-1 yang sah. Gunakan kod dua huruf seperti US, GB, JP.
Kod Bahasa Tidak Sah (400 Bad Request)
Kod bahasa bukan kod ISO 639-1 yang sah. Gunakan kod dua huruf seperti en, es, ja.
Sekatan Geo Masih Aktif (403 Forbidden)
Kandungan masih disekat geo walaupun penyetempatan dilakukan. Sesetengah tapak menggunakan kaedah pengesahan tambahan.
Credits Tidak Mencukupi (402 Payment Required)
Akaun anda tidak mempunyai credits yang mencukupi (perlu 2). Beli lebih banyak credits atau naik taraf pelan anda.
Had Kadar Dilampaui (429 Too Many Requests)
Anda telah melampaui had kadar pelan anda. Tunggu sebentar atau naik taraf pelan anda untuk had yang lebih tinggi.
Kos Credit
Free Plan: 1,000 credit percubaan sekali sahaja = 500 penyetempatan
Hobby Plan: 5,000 credits/bulan = 2,500 penyetempatan ($19/bln)
Professional Plan: 50,000 credits/bulan = 25,000 penyetempatan ($99/bln)
Business Plan: 250,000 credits/bulan = 125,000 penyetempatan ($399/bln)