Entri: kesalahan
Panggilan cek skor domain yang gagal: 401, 402, dan baris kosong
Entri: kesalahan. Dua kode HTTP memiliki makna, satu flag memberi tahu apakah panggilan selesai, dan satu properti data menjelaskan sebagian besar kejutan.
Gejala, penyebab, perbaikan
| Gejala | Penyebab yang mungkin | Perbaikan |
|---|---|---|
| HTTP 401 | Kunci hilang, salah ketik, atau dicabut | Kirim key=sk_... atau header Bearer; salin kunci lagi dari halaman akun |
| HTTP 402 | Kredit telah habis | Isi ulang dalam USDT (TRC-20); tindakan gratis masih berfungsi |
| ok bernilai false | Panggilan tidak selesai | Baca status HTTP terlebih dahulu, lalu badan respons |
| Domain terlihat belum diberi skor | Sedikit atau tidak ada tautan dalam indeks | Lihat domain yang merujuk; DR 0 berarti tidak ada yang ditemukan |
| Tautan terbaru hilang | Pembaruan indeks berlangsung sekitar sebulan sekali | Tunggu pembaruan berikutnya; jangan coba lagi secara berulang |
| Halaman berhenti setelah 50.000 baris | Batas paginasi | Sempitkan dengan kueri atau pengurutan, lalu lakukan paginasi lagi |
| Panggilan massal ditolak | Lebih dari 2.000 domain | Pecahkan daftar menjadi bagian-bagian |
Pembayaran dilakukan dalam USDT pada jaringan TRC-20. Masuk hanya menggunakan Google. Daftar massal dibatasi pada 2.000 domain, panggilan daftar pada 1.000 baris, dan paging mendalam pada 50.000 baris.
Urutan diagnosis
Mulailah dengan kode status. 401 berkaitan dengan identitas dan 402 berkaitan dengan uang. Keduanya diperbaiki di tempat yang berbeda.
Kemudian baca ok. Setiap respons memuatnya. Pada panggilan yang diautentikasi, _credits menunjukkan biaya dan saldo tersisa, sehingga saldo yang habis dapat terlihat sebelum 402 muncul.
Jaga urutan ini tetap dalam runbook Anda. Siapa pun yang langsung melompat ke data dapat menghabiskan pagi hari untuk masalah yang akan segera teridentifikasi oleh kode status.
Hanya setelah itu Anda harus mencurigai data. Situs baru sering kali menunjukkan DR rendah. Penyebabnya jarang merupakan bug. Alasan yang lebih mungkin adalah snapshot bulanan yang mendahului tautannya. Bandingkan angka tersebut dengan entri rumus.
Memisahkan masalah kunci dari masalah saldo
401 dan 402 terlihat serupa dalam skrip, karena keduanya menghentikan loop yang sama. Keduanya memiliki penyebab berbeda, jadi pisahkan sebelum mengubah apa pun.
Mulailah dengan tindakan gratis pada domain yang sama. Jika tindakan gratis berhasil dan panggilan berbayar gagal, domainnya baik-baik saja dan masalahnya terletak pada kunci atau saldo.
Ketika 401 muncul setelah penyalinan
Kunci yang disalin dengan spasi di akhir atau terpotong di bagian akhir adalah penyebab umum 401. Kunci dimulai dengan sk_, jadi periksa awalan tersebut dan bandingkan seluruh string dengan salinan di halaman akun.
Ganti kunci di satu tempat dan jalankan kembali panggilan tunggal yang sama. Mengubah beberapa hal sekaligus membuat hasil sulit dibaca.
Ketika 402 muncul setelah isi ulang
402 berarti tindakan berbayar tidak memiliki sisa kredit. Baca saldo tersisa di _credits pada respons terautentikasi berikutnya sebelum melakukan apa pun.
Jika saldo tersebut terlihat benar, bandingkan dengan biaya panggilan yang gagal. Angka-angka akan menunjukkan apakah panggilan tersebut sekadar lebih besar dari saldo.
Simpan catatan waktu Anda melakukan isi ulang, agar log dan saldo dapat dibandingkan nanti.
Catatan singkat tentang saldo sebelum dan sesudah setiap isi ulang membuat 402 berikutnya lebih mudah dibaca.
Menangani hasil kosong
Konfirmasi bahwa panggilan telah selesai
Baca ok terlebih dahulu. Nilai false berarti panggilan tidak selesai, sehingga daftar kosong tidak memberi tahu Anda apa pun tentang domain.
Periksa nama yang Anda kirim
Nilai q harus berupa domain polos. Skema, jalur, atau spasi liar dapat menghasilkan jawaban kosong yang terlihat seperti jawaban nyata.
Bandingkan dengan tindakan gratis
Jalankan overview pada nama yang sama. Jika overview mengembalikan data dan daftar tidak, tindakan daftar dan batasnya adalah tersangka berikutnya.
Periksa tanggal pembaruan
Indeks diperbarui sekitar sebulan sekali. Tautan yang ditambahkan setelah pembaruan terakhir tidak akan muncul, berapa kali pun Anda memanggil endpoint.
Kebijakan coba ulang minimal
- Jangan coba ulang 401 atau 402 secara otomatis
- Coba ulang kegagalan jaringan dengan jeda yang meningkat
- Berhenti ketika _credits menunjukkan saldo mendekati nol
- Cache jawaban yang berhasil selama sebulan
- Log tindakan dan domain dengan setiap kegagalan
Pertanyaan tepi
Apakah kredit dipotong untuk panggilan yang gagal?
Kami tidak menyatakan aturan penagihan untuk panggilan yang gagal dalam referensi ini. Pantau _credits pada respons terautentikasi berikutnya dan bandingkan saldo tersisa dengan harapan Anda.
Mengapa tindakan gratis berfungsi setelah 402?
Karena domain, overview, stats, dan suggest tidak memerlukan kunci maupun kredit. Hanya tindakan berbayar yang diblokir setelah saldo kosong.
Dari mana nama bidang berasal?
Lihat entri bidang API untuk bentuk umum dan panggil endpoint langsung untuk baris spesifik tindakan.
Mengapa skor bisa terlihat salah tanpa kesalahan
Kadang-kadang setiap bidang tiba tepat waktu dan angkanya masih mengejutkan Anda. Responsnya benar untuk snapshot tersebut, sehingga pertanyaan sebenarnya adalah apa yang terkandung dalam snapshot tersebut.
Tiga situasi menjelaskan sebagian besar kasus ini.
Domain yang baru diluncurkan
Situs yang baru diluncurkan mungkin menunjukkan DR 0 karena snapshot mendahului tautannya. Nol di sini berarti tidak ada domain penghubung yang ditemukan, bukan penilaian terhadap situs.
Tunggu pembaruan berikutnya sebelum Anda membaca angka tersebut sebagai penilaian terhadap situs.
Bandingkan usia domain dengan siklus pembaruan sebelum bertindak. Nama baru dan nama lama yang tidak pernah menarik tautan terlihat serupa dalam snapshot yang sama.
Tautan yang masuk bulan ini
Tautan yang ditambahkan setelah pembaruan terbaru hilang dari angka tersebut. Panggilan berulang mengembalikan jawaban yang sama hingga pembaruan berikutnya tiba.
Catat tanggal tautan dan tanggal snapshot, agar kesenjanganannya mudah dijelaskan kepada siapa pun yang membaca laporan.
Tautan yang hilang
Tautan dapat hilang ketika halamannya dihapus atau situs donor ditutup. Hitungannya kemudian turun meskipun tidak ada perubahan di sisi Anda.
Bandingkan dua snapshot yang berjarak beberapa bulan sebelum menyalahkan endpoint.
Hitung berapa banyak domain yang bergerak, bukan hanya totalnya. Kerugian kecil yang tersebar di banyak situs terlihat berbeda dari kerugian besar dari satu situs.
Di mana setiap perbaikan berada
| Perbaikan | Tempat |
|---|---|
| Kunci baru atau disalin | Halaman akun |
| Isi ulang dalam USDT (TRC-20) | Halaman akun |
| Pengecakanan dan coba ulang | Kode klien Anda sendiri |
| Menunggu pembaruan | Tidak ada yang bisa dilakukan; indeks diperbarui sekitar sebulan sekali |
Mereproduksi kegagalan untuk laporan bug
Kurangi menjadi satu panggilan
Lepaskan loop dan pertahankan satu perintah curl yang gagal.
Rekam respons
Catat status HTTP, nilai ok, dan bidang _credits jika ada.
Coba tindakan gratis pada domain yang sama
Jika overview berhasil dan tindakan berbayar gagal, kesalahan terletak pada kunci atau saldo, bukan domain.
Kirim detailnya
Catat waktu, tindakan, dan karakter pertama dan terakhir kunci, agar panggilan dapat dicocokkan dengan akun. Simpan kunci penuh di luar laporan.
Apa yang harus dicatat dengan setiap panggilan yang gagal
| Rekam | Mengapa ini membantu |
|---|---|
| Status HTTP | Memisahkan 401 dari 402 sekilas |
| Nilai ok | Menunjukkan apakah panggilan telah selesai |
| _credits, ketika ada | Menunjukkan saldo pada saat kegagalan |
| Tindakan dan domain | Memungkinkan Anda mengulang panggilan yang sama dengan sengaja |
| Waktu panggilan | Menempatkannya terhadap pembaruan bulanan |
Mengapa tidak coba ulang otomatis
Looping pada 402 membakar waktu dan tidak menghasilkan apa pun. Looping pada 401 dapat memicu deteksi penyalahgunaan di penyedia mana pun, baik kami maupun Google.
Cadangkan coba ulang untuk kesalahan jaringan, dan berikan jeda yang lebih lama pada setiap coba ulang dibandingkan sebelumnya. Tiga upaya adalah batas atas yang masuk akal untuk pekerjaan malam hari.
Katakanlah pekerjaan malam hari memenuhi 402 pada pukul dua pagi. Mencoba ulang setiap lima menit hingga sarapan menghasilkan sekitar seratus kegagalan identik, dan masing-masing adalah baris log yang harus dibaca seseorang nanti.
Gunakan batas tetap untuk coba ulang jaringan juga, dan log setiap upaya. Batas yang dapat Anda nyatakan dalam satu kalimat mudah dipertahankan ketika pekerjaan berhenti.
Peringatan untuk pekerjaan yang berjalan tanpa pengawasan
Pengecekan skor domain malam hari harus memberi tahu seseorang ketika berhenti, dan harus menjelaskan alasannya. Dua kode tersebut memerlukan peringatan berbeda, jadi pisahkan dalam pesan.
Peringatan pada 401 pertama
Satu 401 biasanya berarti masalah kunci, sehingga satu kegagalan layak mendapat pesan. Menunggu seratus kegagalan identik hanya menunda perbaikan.
Sertakan karakter pertama dan terakhir kunci dalam peringatan, bukan kunci utuh, agar pesan aman untuk dibagikan dengan rekan.
402 layak mendapat pesan tersendiri, karena perbaikannya adalah isi ulang, bukan penggantian kunci.
Pekerjaan yang sunyi belum tentu sehat. Hitung jalankan yang selesai, bukan hanya yang gagal, dan beri peringatan ketika tidak ada pergerakan pada kedua hitungan selama satu siklus penuh.
Peringatan pada saldo yang turun
Atur peringatan pada level yang mencakup sisa jalankan, bukan pada nol. Saldo yang hampir kosong saat pekerjaan dimulai tidak menyisakan ruang untuk coba ulang.
Baca level dari _credits pada setiap respons terautentikasi, sehingga peringatan tidak memerlukan permintaan tambahan.
Crawler dan indeks tautan kami diperbarui sekitar sebulan sekali. Situs yang baru diluncurkan mungkin menunjukkan DR 0, dan itu adalah pembacaan yang benar dari snapshot tersebut, karena belum ada domain penghubung untuk situs tersebut.
