Error "link tidak valid" di API: memeriksa URL sebelum membuat pesanan

Apa arti error "link tidak valid" di API

Error "link tidak valid" berarti API tidak dapat menerima URL di kolom target pesanan. Ini tidak selalu berarti salah ketik pada alamat. Layanan dapat menolak link karena format yang tidak sesuai, jenis halaman, redirect, batasan akses, encoding, atau ketidakcocokan platform dengan layanan.

Pemeriksaan biasanya dilakukan sebelum pesanan dibuat. API menerima URL, menentukan domain dan path, lalu mencoba mengenali objek: channel, video, siaran langsung, publikasi, atau profil. Jika salah satu tahap gagal, pesanan tidak akan dibuat. Teks error umum saja tidak menunjukkan penyebabnya — perlu melihat URL, parameter layanan, dan respons API secara lengkap.

Cocokkan teks error dengan respons API

Setiap API memiliki rumusan dan struktur respons yang berbeda. Terkadang layanan hanya mengembalikan pesan, terkadang menambahkan kode, nama field, atau ID permintaan. Respons lengkap lebih berguna daripada status HTTP: bahkan ketika permintaan berhasil terkirim, API dapat menolak pesanan itu sendiri pada tingkat pemeriksaan bisnis.

Sebagai contoh, respons tipikal dapat terlihat seperti ini: {"error":"invalid_link","message":"Invalid target URL","field":"link"}. Di sini yang perlu diperiksa adalah nilai field link. Varian {"error":"target_not_supported"} lebih sering menunjukkan jenis objek yang tidak didukung, bukan alamat yang rusak. Nama field dan kode bergantung pada dokumentasi masing-masing.

Simpan status respons, body respons, ID layanan, dan request_id jika API mengembalikannya. Jangan menambahkan token akses, cookie, tanda tangan permintaan, dan parameter link privat ke dalam tiket.

Periksa format URL dan nilai field permintaan

Link yang berfungsi di browser belum tentu lolos pemeriksaan mesin. Terkadang yang masuk ke field hanya ID video, nickname tanpa domain, teks dari pesan, atau alamat yang dipendekkan. Error juga muncul ketika URL dikirim bukan sebagai string, melainkan sebagai objek bersarang atau array.

• Kirim URL publik lengkap beserta protokol https://.
• Periksa domain: domain harus milik platform layanan yang dipilih.
• Hapus spasi di awal dan akhir, baris baru, emoji, dan teks setelah link.
• Cocokkan nama field dengan dokumentasi API: link, url, target, atau lainnya.
• Pastikan permintaan mengirim nilai string, bukan objek yang berisi URL di dalamnya.

Menempelkan alamat secara manual memang praktis, tetapi ada kekurangannya: karakter tak terlihat atau potongan keterangan publikasi mudah masuk ke dalam string. Bersihkan nilai sebelum mengirim, tetapi jangan mengubah path dan parameter itu sendiri tanpa alasan.

Buka short link dan hilangkan redirect yang tidak perlu

Alamat yang dipendekkan dan link dari tombol "Bagikan" sering melewati satu atau beberapa redirect. Browser membukanya secara otomatis, tetapi API layanan promosi mungkin tidak mengikuti pengalihan, memblokirnya, atau menerima halaman otorisasi perantara.

Untuk pesanan, sebaiknya gunakan alamat kanonis: alamat yang terlihat di address bar setelah halaman yang dituju dimuat sepenuhnya. Label kampanye dan parameter waktu tonton tidak selalu mengganggu, tetapi parameter dapat mengarah ke tampilan halaman yang berbeda atau memengaruhi pengenalan objek.

URL kanonis memiliki kekurangan: terkadang harus diperoleh secara terpisah, terutama setelah menyalin link dari aplikasi seluler. Namun alamat seperti ini lebih mudah diperiksa secara manual dan dicocokkan dengan aturan layanan.

Pilih link ke objek yang diterima layanan

Layanan mungkin hanya menerima satu jenis target. Pesanan untuk channel tidak akan menerima link ke rekaman siaran, dan layanan untuk penayangan video tidak akan menerima profil penulis. Kedua URL terlihat valid, tetapi API mencocokkan struktur alamat dengan tujuan layanan dan menolak objek yang tidak sesuai.

Periksa direktori layanan: platform, kategori, target_type yang diizinkan, dan batasannya. Jika API memerlukan parameter jenis target terpisah, parameter tersebut harus cocok dengan URL. Jangan mengganti alamat konten dengan link ke pencarian, hashtag, kumpulan, halaman utama, atau dasbor penulis.

• Untuk promosi channel, kirim halaman channel.
• Untuk penayangan, gunakan link ke video atau postingan tertentu.
• Untuk siaran langsung yang aktif, kirim URL siaran jika layanan mendukung format live.
• Untuk reaksi dan tindakan lain pada publikasi, gunakan link langsung ke publikasi.

Periksa privasi, filter usia, dan persyaratan login

API tidak hanya memeriksa bentuk URL, tetapi juga ketersediaan target. Konten mungkin terbuka bagi pemilik channel karena browser-nya terautentikasi, tetapi tidak dapat diakses oleh server pemeriksa eksternal. Dalam kasus ini, layanan sering mengembalikan error umum tentang link tidak valid.

• Periksa apakah profil, channel, publikasi, atau siaran itu sendiri bersifat privat.
• Pastikan video tidak dihapus, dipindahkan ke draf, atau diganti dengan publikasi lain.
• Periksa batasan usia: batasan ini mungkin memerlukan konfirmasi usia atau login akun.
• Nonaktifkan mode akses hanya untuk pelanggan, anggota, atau penonton yang disetujui, jika mode tersebut aktif.
• Pastikan halaman tidak menampilkan formulir login, peringatan konten, atau halaman placeholder teknis.

Buka link di jendela privat tanpa otorisasi. Jika yang terlihat adalah permintaan login alih-alih halaman tujuan, ubah pengaturan akses atau pilih layanan yang mengizinkan jenis target tersebut, jika tersedia. Kekurangan pemeriksaan di jendela privat adalah tidak selalu dapat mendeteksi batasan regional dan jaringan.

Perhatikan alamat regional, seluler, dan tersemat

Satu objek dapat memiliki URL desktop, seluler, terlokalisasi, dan tersemat. Alamat dari aplikasi atau webview terkadang mengandung segmen teknis yang tidak dikenali API. Halaman terlokalisasi juga dapat terbuka secara berbeda bagi server pemeriksa.

Buka link yang disalin di browser biasa dan tunggu hingga dimuat sepenuhnya. Untuk permintaan, gunakan alamat web publik dari address bar. Jika konten dibatasi berdasarkan wilayah, hapus batasan tersebut jika pengaturan platform mengizinkannya, atau jangan kirim target seperti itu ke layanan yang memerlukan akses publik.

Link web publik tanpa otorisasi dan tanpa layar perantara adalah pilihan paling andal untuk pemeriksaan API.

Hindari kerusakan URL saat mengirim permintaan

Link mungkin benar sebelum dikirim, tetapi berubah saat serialisasi JSON, penyusunan parameter query, pengiriman form-data, atau encoding ulang. Karakter &, ?, #, dan % sangat sensitif. Misalnya, ampersand dalam URL dapat menjadi pemisah parameter permintaan itu sendiri jika alamat dikirim tanpa encoding yang diperlukan.

• Bandingkan URL asli dengan nilai dalam permintaan HTTP yang sebenarnya.
• Periksa body permintaan di log klien, proxy, atau alat pengembang.
• Untuk JSON, gunakan serialisasi bawaan, bukan penyusunan string manual.
• Jangan melakukan encoding URL dua kali jika library melakukannya secara otomatis.
• Periksa penanganan karakter non-ASCII di path dan parameter alamat.

Log membantu menemukan ketidakcocokan dengan cepat, tetapi ada kekurangannya: kunci API, token, dan data pribadi dapat ikut tercatat. Masking nilai sensitif sebelum mencatat dan mengirim log.

Cocokkan platform, ID layanan, dan parameter pesanan

Beberapa API memeriksa layanan terlebih dahulu, lalu domain dan jenis link. URL dari platform lain, service_id yang sudah usang, atau target_type yang salah dapat menyebabkan error "link tidak valid" yang sama. Dalam kasus ini, mengubah alamat itu sendiri tidak berguna sampai parameter pesanan diperbaiki.

Perbarui katalog layanan melalui metode API jika tersedia. Cache dengan daftar lama dapat menyimpan layanan yang dinonaktifkan atau persyaratan lamanya. Pembaruan katalog yang terlalu sering memiliki kekurangan: meningkatkan jumlah permintaan dan dapat bertabrakan dengan batas laju. Gunakan cache dengan masa simpan terbatas dan perbarui setelah error validasi.

Periksa link secara berurutan sebelum mengirim ulang

1. Salin URL lengkap tanpa teks, spasi, dan karakter tersembunyi.
2. Buka di jendela privat tanpa login ke akun.
3. Periksa bahwa halaman tidak privat, tidak dihapus, dan tidak memerlukan login.
4. Pastikan tidak ada batasan usia, langganan, atau regional.
5. Buka short link hingga alamat publik akhirnya.
6. Cocokkan objek dalam URL dengan layanan: channel, video, siaran langsung, atau publikasi.
7. Cocokkan platform, service_id, dan target_type dengan katalog layanan terkini.
8. Periksa body permintaan HTTP yang sebenarnya dan encoding URL.
9. Simpan respons API lengkap dan ID permintaan tanpa token dan data privat.

Jika setelah pemeriksaan ini error masih berlanjut, kirimkan ke dukungan link dalam bentuk yang sudah dibersihkan, ID layanan, waktu permintaan, status HTTP, dan teks lengkap respons API. Ini akan membantu membedakan masalah URL dari batasan layanan tertentu atau kegagalan pemeriksaan di sisi layanan.