Pemeriksa Endpoint API

Pemeriksaan respons opsional

Kosongkan kolom pemeriksaan yang ingin dilewati. Header yang tersembunyi atau isi respons yang tidak dapat dibaca menghasilkan status Tidak tersedia, bukan Gagal.

CORS menentukan respons dan header yang dapat dibaca halaman ini. Server tujuan menerima permintaan dan alamat IP Anda.

Status
Durasi
ms
Byte
URL akhir setelah pengalihan:
Pratinjau berhenti pada 1 MiB. Endpoint mungkin mengembalikan lebih banyak data.

Pemeriksaan respons

Laporan satu permintaan dengan data disamarkan

Unduhan memuat metode, endpoint yang disamarkan, status akhir, waktu, dan hasil pemeriksaan. Jalur serta kueri URL, header dan isi permintaan, serta isi respons dan nilai header respons tidak disertakan.

Kirim permintaan GET, HEAD, POST, PUT, PATCH, atau DELETE dari browser Anda dan periksa respons akhirnya. Tambahkan pemeriksaan opsional untuk kode atau rentang status, header respons yang diekspos, dan properti JSON. Setiap pemeriksaan menampilkan Lulus, Gagal, atau Tidak tersedia. Alat ini menampilkan status akhir, waktu hingga header respons tiba, header yang dapat dilihat browser, dan teks respons hingga 1 MiB. Permintaan hanya dikirim saat Anda memilih Kirim permintaan.

Cara memeriksa endpoint API

  1. 1

    Masukkan detail permintaan

    Masukkan URL HTTP atau HTTPS dan pilih metode. Tambahkan header atau isi permintaan jika diperlukan endpoint. GET dan HEAD tidak mengirim isi yang Anda masukkan.

  2. 2

    Tentukan hasil yang diharapkan

    Gunakan kode seperti 200, rentang seperti 200-204, atau kelompok seperti 2xx. Anda juga dapat mengisi nama header respons dan jalur JSON, masing-masing dengan nilai yang diharapkan jika perlu. Kosongkan kolom untuk melewati pemeriksaannya.

  3. 3

    Kirim dan baca hasilnya

    Pilih Kirim permintaan satu kali. Baca status akhir dan hasil setiap pemeriksaan. Header yang tersembunyi, respons yang tidak dapat dibaca, atau isi JSON yang tidak lengkap dapat membuat pemeriksaan berstatus Tidak tersedia.

  4. 4

    Simpan laporan dengan data disamarkan

    Unduh laporan teks atau JSON untuk pemeriksaan ini. Laporan memuat origin endpoint, metode, status akhir, waktu, dan hasil pemeriksaan, tetapi tidak memuat jalur serta kueri URL, nilai permintaan, atau isi respons.

Contoh pemeriksaan respons

Misalnya, endpoint milik Anda sendiri, GET https://api.example.com/health, mengembalikan status 200, header Content-Type: application/json yang diekspos, dan {"status":"ready"}. Anda dapat mengisi:

Kolom opsional Contoh Yang diperiksa
Kode status yang diharapkan 200, 204 atau 2xx Apakah status akhir termasuk dalam himpunan yang dipilih.
Nama header respons Content-Type Apakah browser dapat melihat header ini.
Nilai header yang diharapkan application/json Apakah nilai yang terlihat cocok persis. Kosongkan kolom ini jika hanya ingin memeriksa keterlihatannya.
Jalur properti JSON $.status Apakah properti ini ada dalam respons JSON yang lengkap.
Nilai JSON yang diharapkan "ready" Apakah nilai JSON setelah diuraikan cocok. Kosongkan kolom ini jika hanya ingin memeriksa keberadaan properti.

Kolom nilai JSON menerima sintaks JSON: gunakan true untuk boolean, 42 untuk angka, dan "ready" untuk string. Jalur dimulai dengan $ dan mendukung properti serta indeks array, misalnya $.data.items[0].id. Jalur tidak menjalankan skrip atau mendukung filter. Jika properti tidak ada dalam JSON yang dapat dibaca, pemeriksaannya Gagal. Header yang tidak ada atau disembunyikan oleh CORS menghasilkan Tidak tersedia karena browser tidak dapat membedakan keduanya.

Apa yang dapat dipastikan dari hasilnya

Hasil Arti
Lulus Respons akhir yang dapat dibaca memenuhi persyaratan tersebut.
Gagal Respons akhir yang dapat dibaca tidak sesuai dengan persyaratan, atau properti JSON yang diminta tidak ada.
Tidak tersedia Browser tidak dapat menentukan hasilnya, misalnya karena respons tidak dapat dibaca, header tidak ada atau tersembunyi, atau isi JSON kosong, tidak lengkap, atau tidak valid.

Pengukur waktu berhenti saat header respons tiba. Waktu ini tidak mencakup pengunduhan seluruh isi respons. Permintaan berhenti setelah 15 detik; isi permintaan dibatasi 1 MiB dan pratinjau respons berhenti setelah 1 MiB. Pratinjau yang terpotong tidak cukup untuk memastikan hasil pemeriksaan properti JSON. Respons HEAD dan 204 tidak memiliki isi yang dapat diperiksa, sehingga pemeriksaan JSON berstatus Tidak tersedia. Alat mengikuti pengalihan dan melaporkan URL akhir, tetapi tidak menampilkan setiap tahap pengalihan atau otomatis mengulangi permintaan. Aturan CORS browser dapat menghalangi pembacaan respons meskipun endpoint telah menerima permintaan. Browser juga dapat mengirim permintaan prapemeriksaan CORS sebelum metode yang diminta.

Hanya header respons yang diekspos ke browser yang dapat diperiksa. Untuk header khusus, endpoint mungkin perlu mencantumkannya dalam Access-Control-Expose-Headers. Header yang tidak terlihat di halaman ini bisa saja tidak ada di server atau sekadar disembunyikan oleh CORS. Periksa log server atau gunakan klien API yang sesuai jika Anda perlu membedakan keduanya.

Pertanyaan yang Sering Diajukan

Gagal berarti respons yang dapat dibaca browser tidak sesuai dengan hasil yang diharapkan. Tidak tersedia berarti browser tidak dapat memastikan hasilnya. Misalnya, browser tidak dapat membedakan header yang tidak ada dari header yang disembunyikan CORS, serta tidak dapat memeriksa JSON dalam isi yang kosong, tidak dapat dibaca, atau terpotong.

Anda dapat memasukkan header Authorization jika endpoint mengizinkan permintaan browser ini melalui CORS. Pemeriksa tidak menyertakan cookie browser atau kredensial bawaan lainnya. Nilai header Anda dikirim langsung ke tujuan, jadi gunakan kredensial hanya untuk endpoint yang Anda percayai.

Browser Anda mengirim permintaan langsung ke tujuan, yang menerima permintaan tersebut beserta alamat IP Anda. URL, header, dan isi permintaan yang Anda masukkan tidak melewati server situs ini dan tidak muncul di URL halaman alat. Laporan yang disamarkan tetap memuat asal endpoint, tetapi tidak memuat bagian URL lainnya, header permintaan, atau isinya. Untuk berpindah antar langkah, pemeriksa menyimpan masukan Anda sebentar di penyimpanan sesi tab ini. Catatan tersebut berlaku paling lama lima menit dan dihapus saat dibaca, saat Anda memulai lagi, atau setelah pemeriksaan. Skrip di situs ini dapat membaca catatan selama masih tersimpan. Jika browser Anda memblokir penyimpanan, Anda dapat mengirim permintaan dari halaman yang sama.

Satu laporan teks atau JSON dibuat untuk pemeriksaan saat ini. Isinya mencakup origin endpoint, metode, status akhir, waktu hingga header respons tiba, jumlah byte yang ditangkap, penanda pengalihan dan pemotongan, serta hasil pemeriksaan. Laporan tidak memuat jalur, kueri, dan fragmen URL; header permintaan beserta nilainya; isi permintaan; header respons beserta nilainya; ataupun isi respons. Tinjau berkas sebelum membagikannya karena origin dan hasil pemeriksaan masih dapat mengungkap identitas layanan Anda.

Pengukur waktu mulai tepat sebelum browser menjalankan Fetch dan berhenti saat header respons akhir tiba. Waktu ini mencakup proses browser dan jaringan serta pengalihan yang diizinkan, tetapi tidak mencakup pembacaan isi respons. Log server mungkin mengukur rentang waktu yang berbeda.

Tidak. Kirim permintaan menjalankan satu pemeriksaan saat Anda memilihnya. Alat tidak menjadwalkan, otomatis mengulang, atau memantau permintaan. Prapemeriksaan CORS oleh browser dan pengalihan yang diikuti tetap dapat menambah permintaan jaringan dalam satu pemeriksaan.

Alat Terkait

Alat ini tersedia dalam bahasa lain