Kaedah penyelesaian masalah pengecualian API


1. Penyelesaian masalah pantas

1 a219a.7386781.0.0.g5ZY6Y

Alamat pusat peraturan: //open.taobao.com/doc/detail.htm?id=101612

TB1k0YFFVXXXXbFXpXXSutbFXXX.jpgMaklumat hubungan perkhidmatan pelanggan Taobao: http://www.taobao.com/about / contact.php

Alamat alat ujian API: http://my.open.taobao.com/apitools/apiTools.htmAlamat senarai kod ralat: //open.taobao.com/doc/detail.htm?id = 101645

Alamat forum: //open.taobao.com/bbs/forum.php

Alamat FAQ: //open.taobao.com/doc/detail.htm?id=101783

Alamat pusat sokongan: //open .taobao.com/support/index.htm?spm=a219a.7386781.0.0.r8QQcW

Kumpulan soalan kecemasan: 228708748

Penjelasan terperinci tentang masalah dalam carta alir

Masalah bukan API

Masalah yang berlaku sebelum pembangun menghantar permintaan HTTP untuk data Taobao, termasuk masalah perniagaan Taobao, masalah perniagaan dan ralat kontena.

1. Masalah perniagaan Taobao:

(1) Isu peraturan perniagaan, seperti: produk atau pengguna dihukum, dll.

(2) Masalah dengan operasi yang tidak berjaya di halaman Taobao, seperti: tidak dapat melihat produk untuk dijual di bahagian belakang Taobao Tunggu

2 Isu perniagaan:

(1) Isu akses aplikasi, seperti: berapa banyak aplikasi yang boleh didaftarkan oleh pembangun, dsb.

(2) Isu semakan aplikasi, seperti: aplikasi mana yang tidak. akses sokongan, dsb.

( 3) Isu pelancaran aplikasi, seperti: cara mengehadkan kekerapan panggilan, dsb.

3 Isu ralat kontena:

Melalui bekas, pengguna boleh membenarkan pembangun mendapatkan maklumat data mereka, terutamanya apabila kod ralat pada halaman adalah antara 100 dan 200 ralat di antaranya.

Isu API

Masalah yang berlaku selepas pembangun menghantar permintaan HTTP untuk data Taobao, termasuk ralat sambungan HTTP, ralat peringkat platform dan ralat peringkat perniagaan ini ialah semasa mengakses pelayan Taobao yang timbul pada tiga peringkat: platform akses TOP dan pelayan perniagaan belakang Taobao.


1. Masalah ralat sambungan HTTP:

Ralat yang berlaku semasa permintaan ke pelayan Taobao ini biasanya ditandakan dengan kod respons HTTP terdiri daripada tiga digit perpuluhan mesej yang dihantar oleh pelayan HTTP Baris pertama respons. Terdapat lima jenis kod respons, diwakili oleh digit pertamanya:

1xx: Maklumat, permintaan diterima, pemprosesan diteruskan
2xx: Berjaya, tindakan telah berjaya diterima, difahami dan diterima pakai
3xx: Ubah hala, untuk melengkapkan Permintaan, tindakan yang mesti dilakukan selanjutnya
4xx: Ralat pelanggan, permintaan mengandungi ralat sintaks atau permintaan tidak dapat dilaksanakan
5xx: Ralat pelayan, pelayan tidak dapat melaksanakan permintaan yang jelas tidak sah

Respons paling biasa diterima oleh pembangun apabila memanggil Perkhidmatan TOP ialah 200 : Permintaan http berjaya 404: Perkhidmatan yang diminta tidak ditemui 500 Ralat pelayan dalaman, dsb. Jika kod respons yang diterima oleh pembangun ialah 404, bermakna terdapat masalah dengan rangkaian pengguna Jika kod respons yang diterima oleh pembangun ialah 500, bermakna rangkaian itu normal tetapi perkhidmatan teratas tidak boleh bertindak balas.

Jika terdapat masalah dengan rangkaian tempatan, anda boleh terus masuk ke baris arahan ping gw.api.taobao.com untuk menguji kelajuan meminta pelayan Taobao Jika kelajuan sangat perlahan, pertimbangkan untuk mempercepatkan pelayan. Jika ping gagal, hubungi pentadbir rangkaian untuk pengesahan sama ada pelayan menyekat nama domain Taobao.

2. Masalah ralat peringkat platform:
Ralat berlaku apabila meminta TOP untuk mengakses platform Pada masa ini, kod ralat yang dikembalikan oleh TOP adalah kurang daripada 100. Ralat ini biasanya disebabkan oleh permintaan pengguna yang tidak mematuhi kebenaran. , keselamatan, lalu lintas dan parameter paling asas Disebabkan oleh pengesahan.

3. Masalah ralat peringkat perniagaan:
Apabila meminta masalah dengan pelayan perniagaan bahagian belakang, kod ralat yang dikembalikan adalah antara 500 dan 1000. Untuk kod dan penyelesaian subralat tertentu, sila rujuk dokumentasi API.

2. Carta aliran penyelesaian masalah terperinci

Perincian aliran pemprosesan pembangun selepas menemui masalah di atas. Contoh penyelesaian masalah pantas kesilapan :ERROR_MORE_THAN_ALLOWED_RECOMMEND_NUM (melebihi jumlah cadangan tetingkap) Terdapat banyak ralat, bagaimana untuk menyelesaikannya?

Mula-mula cari masalah API mengikut proses penyelesaian masalah, dan kemudian semak penyelesaian kod ralat dalam dokumen API: T1jOVMXbxCXXaMCXbX.jpg

1 Apabila mengesyorkan tetingkap, pengguna dikehendaki memasukkan jumlah pengesyoran tetingkap akan kehilangan lebih banyak, jadi laporkan pengesyoran tetingkap Jika ralat melebihi bilangan pengesyoran maksimum, jumlah bilangan pameran akan dikemas kini dengan kerap setiap hari Jumlah bilangan pameran = pameran yang disyorkan + pameran yang tinggal (ralat ini tidak boleh dihapuskan sepenuhnya).

2 Pembangun mula-mula memanggil antara muka taobao.shop.remainshowcase.get untuk mendapatkan penjual Buat pertimbangan logik pada baki bilangan tetingkap paparan, dan kemudian hubungi antara muka pengesyoran tetingkap.

Contoh 2

Atur cara setempat melaporkan ralat tetapan semula sambungan dan tiada kod ralat teratas dikembalikan.
Cadangan:

1. Mengurangkan tugas dengan munasabah, mengurangkan kebutiran tugasan, mengurangkan masa transaksi, meningkatkan kadar kejayaan pelaksanaan transaksi dan mengurangkan kos pemulangan semula

2 kemungkinan operasi berulang;

3. Periksa sama ada terdapat antara muka operasi kelompok untuk mengurangkan bilangan panggilan gelung tunggal

4 prestasi sebenar dan kapasiti pemprosesan pelayan lain.

Pertama sekali, sumber tempatan adalah terhad (semakin banyak utas yang anda buka, semakin tinggi kekerapan kitar semula GC tempatan, yang menjejaskan kelajuan pelaksanaan dan mengurangkan kecekapan Kedua, pihak yang satu lagi mungkin menolak sambungan secara aktif disebabkan terlalu banyak sambungan IP; (perlindungan DOS)

Sekali lagi, saluran tidak boleh digunakan semula. (Versi 1.6 JDK semasa telah dapat menggunakan semula saluran TCP dengan lebih baik. Membuka sejumlah besar saluran TCP secara serentak adalah satu kerugian. Kadangkala siri separa akan mengurangkan bilangan saluran TCP yang dijana ke tahap tertentu dan menggunakan saluran secara rasional. Untuk meningkatkan kecekapan dan kadar kejayaan, pelanggan juga penting untuk melakukan kawalan aliran)

Contoh 3

Penyelesaian kepada masalah kehilangan paket rangkaian:

Latar belakang masalah:

1 Talian fizikal Internet bukan 100 %, terdapat kehilangan data dalam komunikasi antara pelayan ISV dan TOP

2. Pembangun memerlukan cara untuk mengesahkan sama ada data yang diperolehi oleh setiap capaian lengkap dan sama ada terdapat kehilangan paket

3 Pada masa ini, sesetengah ISV menggunakan kaedah ini untuk mengesahkan integriti: memanggil API beberapa kali berturut-turut dan membandingkan hasil yang dikembalikan. Kaedah ini tidak boleh dipercayai (berbilang panggilan mungkin mengembalikan hasil perniagaan yang berbeza), meningkatkan kos pembangunan ISV, dan juga meningkatkan tekanan pelayan TOP:

Untuk menyelesaikan masalah data pengesahan ISV yang disalurkan oleh pembangun Untuk kesempurnaan, TOP telah menambah. elemen baharu pada Pengepala HTTP: panjang badan atas.

Cara menggunakan: Pembangun mendapat nilai panjang badan atas ini dan mengira panjang Badan HTTP yang diterima Jika kedua-duanya sama, ini bermakna data yang dikembalikan adalah lengkap Jika panjang Badan HTTP yang dikira adalah kurang daripada bahagian atas -bodylength Nilai menunjukkan kehilangan paket telah berlaku.

Nota:

1: TOP tidak mengubah Badan HTTP, jadi ia tidak akan memberi kesan kepada aplikasi sedia ada.

2: panjang badan atas ialah panjang aksara String yang mewakili Badan HTTP (tidak kira bahasa Cina dan Inggeris, kedua-duanya dikira sebagai 1 panjang)

2 Senarai kod ralat

1 memanggil API Terdapat tiga jenis ralat yang mungkin berlaku: ralat platform API, ralat perniagaan ISV dan ralat kontena. Berikut adalah pengenalan kepada kata nama yang berkaitan dengan kadar kejayaan ISV:

Lawatan berkesan = lawatan berjaya + kesilapan perniagaan ISV (lawatan berjaya merujuk kepada panggilan yang memperoleh data secara normal dan tiada ralat)

Kadar kejayaan ISV = Lawatan yang berjaya/Lawatan berkesan

2 Ralat semasa menyambung ke pelayan Taobao terutamanya kesilapan sambungan http atau penetapan semula sambungan dan penolakan jawapan dalam talian.

1. Ralat platform API

Ralat platform API terutamanya termasuk dua jenis ralat:

(1) Ralat panggilan dengan kod ralat kurang daripada 100 (tidak termasuk 15 dan 4) kod , Ralat ini biasanya disebabkan oleh permintaan pengguna yang tidak mematuhi pelbagai semakan asas. Apabila pengguna menghadapi ralat ini, mereka mula-mula menyemak kebenaran aplikasi, kekerapan, dsb., dan kemudian merujuk kepada dokumentasi untuk menyemak sama ada parameter masuk adalah lengkap dan sah.

(2) Kod subralat (sub_code) ialah ralat panggilan bermula dengan "isp." Ralat ini biasanya disebabkan oleh pengecualian bahagian pelayan. Pengguna yang menghadapi jenis ralat ini perlu mencuba lagi selepas tempoh masa untuk menyelesaikannya.

Ralat peringkat platform dengan kod ralat kurang daripada 100
Kod Ralat Kod Keterangan-Keterangan Keterangan-Keterangan-Keterangan Kejutan Kecala 3Upload Gagal Gagal Gagal. , anda perlu mengurangkan saiz imej atau meningkatkan lebar jalur rangkaian dan mencuba 7App Call Limited Jumlah panggilan aplikasi melebihi had, termasuk kekerapan panggilan melebihi program pelarasan had untuk memanggil API dengan betul Dilalui sebelum membuat panggilan semula. Kekerapan panggilan Taoke adalah mengikut sistem di atas Jumlah transaksi bulanan diubah suai secara automatik, dan kekerapan yang disemak akan dimaklumkan dalam bentuk pengumuman di laman utama forum rasmi 9Http Tindakan Tidak Dibenarkan Kaedah HTTP adalah dilarang Sila gunakan POST atau GET huruf besar Jika terdapat gambar dan maklumat lain yang dihantar, Anda mesti menggunakan POST 10Perkhidmatan Tidak Tersedia kebanyakannya disebabkan oleh pengecualian yang tidak diketahui dengan teliti perihalan dokumen. 11Kebenaran ISV yang tidak mencukupi Kod sub-ralat pada masa ini mempunyai isv.permission-api-package-kosong tidak dikaitkan dengan mana-mana pakej akses . isv.permission-api-package-not-allowed tidak membenarkan akses kepada API kumpulan yang tidak boleh diakses Adalah disyorkan untuk menyemak sama ada label aplikasi yang anda mohon adalah betul kumpulan tidak boleh diakses, anda perlu memohon kebenaran daripada baris perniagaan yang sepadan mengikut peraturan perniagaan Contohnya: dalam kumpulan tidak boleh diakses pembeli, akan terdapat beberapa API pesanan yang tidak membenarkan aplikasi pembeli mengakses isv.permission-api-. package-limit. Pakej yang berkaitan tidak Untuk membenarkan akses kepada API, adalah disyorkan untuk memohon kebenaran yang sepadan isv.permission-ip-whitelist-limit mengikut peraturan perniagaan tidak membenarkan akses untuk mengkonfigurasi senarai putih IP yang betul isv.permission-api-widget-only-limit dalam pusat keselamatan Hanya Benarkan akses widget (komponen) 12Kebenaran Pengguna Tidak MencukupiKebenaran Pengguna Tidak MencukupiAplikasi tidak mempunyai kebenaran untuk memanggil antara muka kebenaran tambah nilai. Anda boleh menyerahkan permohonan kebenaran dalam Bahagian Belakang Rakan Kongsi Taobao13Kebenaran Rakan Kongsi Tidak MencukupiKebenaran Rakan Kongsi Tidak MencukupiAplikasi tidak mempunyai kebenaran untuk memanggil antara muka kebenaran tambah nilai Anda boleh menyerahkannya dalam latar belakang Rakan Kongsi Taobao menyerahkan permohonan kebenaran 21Kaedah Hilang Parameter nama kaedah yang masuk. parameter ditambahkan pada medan kaedah 22Kaedah Tidak Sah Nama kaedah tidak wujud Medan kaedah masuk mestilah nama API yang anda panggil dan API sebenarnya wujud 23Format Tidak Sah Format data tidak sah atau xml.Untuk algoritma, sila lihat: //open.taobao.com/doc/detail.htm?id=101617#ss226Missing Session tiada parameter SessionKey Parameter lulus masuk mesti mengandungi medan sesi 27Sesi Tidak Sah, nyahcampur-sessionkey -failure Invalid SessionKey parameter dihantar masuk. Sesi mesti diperoleh oleh pengguna yang mengikat sesi Jika sesi yang dilaporkan adalah menyalahi undang-undang, ia mungkin disebabkan oleh pengguna tidak mengikat sesi atau sesi telah tamat tempoh dan kemudian lulus dalam sessionKey28Missing App Key yang baharu tiada parameter AppKey yang diluluskan dalam Parameter mesti menyertakan medan app_key 29Kunci Apl Tidak Sah Parameter AppKey Tidak Sah Persekitaran di mana aplikasi berada tidak konsisten dengan persekitaran yang dipilih. Contohnya: aplikasi berada dalam persekitaran ujian kotak pasir tetapi memilih untuk diuji dalam persekitaran rasmi. 30Stamp masa tiada parameter cap masa Parameter yang diluluskan mesti mengandungi parameter cap masa 31 Cap masa tidak sah ialah cap waktu parameter cap masa yang tidak sah Formatnya ialah yyyy-mm-dd hh:mm:ss, contohnya: 2008-01-20. :23:30 . Pelayan API Taobao membolehkan pelanggan meminta ralat masa 10 minit 32 Versi Tiada parameter versi Parameter masuk mesti mengandungi medan v Versi Tidak Sah format yang salah dan mesti dalam format angka 34 Versi Tidak Disokong Nombor versi yang dihantar oleh pengguna tidak diberikan. Keizinan sesi yang tidak mencukupi tidak mencukupi dokumen tahap keselamatan //open.taobao.com/doc/detail.htm?id=100243 Ralat Parameter Ia biasanya disebabkan oleh parameter haram yang dihantar oleh pengguna Sila semak dengan teliti sama ada format dan julat parameter input kepada satu-ke-satu 44Token akses tidak sah biasanya merupakan kunci sesi yang diperolehi oleh pengguna menggunakan protokol teratas dan digunakan sebagai token akses untuk memanggil API atau memanggil persekitaran melalui https Ralat 47Ralat pengekodan tidak sah biasanya disebabkan oleh pengguna tidak menggunakan pengekodan UTF-8 semasa membuat permintaan http Mesej ralat format kod ralat sub sama ada pemilik boleh mencuba semula isp.***-service-unavailable dalam program untuk memanggil perkhidmatan back-end. *** membuang pengecualian, perkhidmatan tidak tersedia ISP adalah isp.remote-service-error untuk menyambung dari jauh Ralat perkhidmatan ISP ialah isp.remote-service-timeout Sambungan masa tamat perkhidmatan jauh ialah isp.remote-connection-error. Ralat sambungan jauh ISP ialah isp.null-pointer-exception Ralat pengecualian penunjuk nol ISP Tiada isp.top-parse-error Ralat penghuraian API (mesej pengecualian yang tidak dikawal secara eksplisit berlaku) ISP Tiada isp.top-remote-connection-timeouttop ISP tamat masa perkhidmatan hujung belakang sambungan platform Ya isp.top-remote-connection-errortop Ralat perkhidmatan hujung belakang sambungan platform, tidak ditemui ISP perkhidmatan ialah isp.top-mapping-parse-errortop-mapping ralat penukaran, terutamanya kerana format parameter masuk tidak betul . ISP Tiada perkhidmatan back-end sambungan platform isp.unknown-errortop membuang maklumat pengecualian yang tidak diketahui ISP ialah

2. Ralat perniagaan ISV

1 Ralat peringkat perniagaan ISV ialah ralat yang disebabkan oleh parameter ISV yang hilang, tidak betul atau diformatkan. Oleh itu, isv harus menyemak sama ada maklumat yang sepadan telah dihantar berdasarkan mesej ralat Untuk jenis ralat ini, disyorkan untuk membetulkannya dan cuba lagi. . lulus masuk tidak betul. :2.

(2) Kod ralat lebih besar daripada 100 atau sama dengan 15 dan kod subralat (sub_kod) bermula dengan "isv."【( kod ralat> 100 atau kod ralat = 15 ) dan (bermula dengan isv.)】 Ralat panggilan:

2 Respons ralat adalah manifestasi paling langsung kegagalan interaksi antara pengguna dan pelayan Apabila isv memanggil perkhidmatan teratas, jika panggilan gagal. sila cuba simpan log ralat untuk pengesanan ralat kemudian. Pengenalan ralat 3, 40/41 dalam dokumen API Parameter yang dipilih mesti diluluskan, sila semak dokumen dengan teliti 41Argumen Tidak Sah Jenis parameter tidak sah adalah salah, contohnya: jenis nombor perlu dihantar, tetapi parameter jenis aksara diluluskan dalam

4 . Sub-ralat peringkat perniagaan

Pemilik mesej ralat format kod ralat boleh mencuba semula dalam program isv.###-tidak wujud: ***Tidak boleh bertanya mengikut *** ###ISV Tiada isv.missing-parameter: ***Tiada parameter yang diperlukan***ISV Tiada isv.invalid-paramete:***Parameter*** tidak sah, format tidak betul, nilai tidak sah, di luar had, dsb. ISVNo isv.invalid -permission is not enough , Akses tidak sah kepada ISV No isv.parameters-mismatch:***-and-###Parameter masuk *** dan ### tidak sepadan, dan terdapat surat-menyurat tertentu antara kedua-duanya. ISV No isv.***-service -error: ### Memanggil *** perkhidmatan mengembalikan palsu, ralat logik perniagaan, ### menunjukkan mesej ralat khusus No ISV

3. Tahap keselamatan dan kod ralat kerentanan keselamatan

Maklumat kod ralat ibu bapa

53

Kod ralat

Huraian Bahasa Inggeris

Huraian Bahasa Cina

Tahap keselamatan yang tidak mencukupi

Tahap keselamatan yang tidak mencukupi

Tingkatkan tahap keselamatan aplikasi atau muat semula tahap keselamatan kebenaran

🎜🎜

Maklumat kod ralat sub

Tiada kebenaran tahap R1. . Belum ada FAQ tentang dokumen ini

Maklumat kod ralat sub

Pesta atribusi

Penyelesaian

pelanggaran keselamatan berisiko tinggi

Dikeluarkan semula selepas menyelesaikan kerentanan keselamatan

perlanggaran keselamatan berisiko pertengahan adalah bahaya

kelemahan keselamatan

ISV

Dikeluarkan semula selepas membetulkan kelemahan keselamatan

ISV.

Keizinan peringkat R1 tamat tempoh

ISV

untuk kebenaran tahap R1 (pengizinan semula pengguna atau kebenaran muat semula)

ize hilang

Tidak dibenarkan pada tahap R2

.

R2 Keizinan tahap tamat tempoh

ISV

Lakukan kebenaran tahap R2 (pengguna memberi kebenaran semula atau menyegarkan kebenaran)

W1 kebenaran keselamatan hilang

Tidak dibenarkan tahap W1

W1 Keizinan tahap tamat tempoh

ISV

Lakukan kebenaran tahap W1 (pengguna memberi kebenaran semula atau menyegarkan kebenaran)

W2 kebenaran keselamatan tidak sah

Tidak dibenarkan tahap W2

W2 Keizinan tahap tamat tempoh

ISV

Lakukan kebenaran tahap W2 (pengguna memberi kebenaran semula atau menyegarkan kebenaran)

4. Kod ralat unik yang lain

FAQ

←
→