API Pencarian Plagiarisme: Pertanyaan dan Jawaban

API PS

API (Antarmuka pemrograman aplikasi) adalah sekumpulan rutinitas, protokol, dan alat untuk membangun aplikasi perangkat lunak. Ini dibuat untuk membantu organisasi memeriksa teks dalam jumlah besar melalui sistem mereka. API kami memberi pelanggan peluang unik untuk mengintegrasikan perangkat lunak kami ke dalam sistem mereka sendiri untuk menjadikan pemeriksaan plagiarisme sebagai proses otomatis. Karena integrasi API memerlukan pengetahuan khusus dan biasanya diselesaikan oleh spesialis teknis, banyak pertanyaan muncul tentang fitur khususnya untuk memastikan pengoperasian yang efisien. Dalam artikel ini kami mengumpulkan pertanyaan-jawaban paling populer tentang kinerja API kami, dan solusi terhadap masalah yang paling sering dihadapi pelanggan kami selama proses integrasi.

Selain itu, integrasi API memberi klien kami peluang untuk memanfaatkan Penyimpanan pribadi. Pelanggan dapat mengunggah arsip mereka sendiri ke dalam sistem Penyimpanan dan menyimpan teks yang diperiksa plagiarisme melalui API kami, sehingga menciptakan Penyimpanan individual. Memeriksa teks untuk plagiarisme terhadap Penyimpanan pribadi memungkinkan pelanggan kami mendeteksi dan mencegah plagiarisme diri. Baca selengkapnya tentang fungsi penyimpanan pribadi di panduan kami https://plagiarismsearch.com/plagiarism-database.

Fitur apa saja yang tersedia melalui API?

  1. Memeriksa teks dan dokumen untuk mengetahui adanya plagiarisme
  2. Akses ke laporan plagiarisme (riwayat pemeriksaan plagiarisme)
  3. Kemampuan untuk mengunggah database klien ke dalam penyimpanan dan melihat dokumen di penyimpanan
  4. Pengecer mempunyai kesempatan untuk membuat beberapa akun pengguna dan menugaskannya dengan jumlah kiriman/kata yang sesuai. Opsi ini akan memberikan kemungkinan bagi setiap referral untuk menggunakan akunnya secara mandiri.

Bagaimana saya bisa mendapatkan akses ke API?

Anda dapat mengakses API kami secara gratis selama 30 hari. Anda juga akan memiliki 100 kiriman dan Penyimpanan pribadi untuk menguji semua manfaat layanan kami. Silakan mendaftar menggunakan tautan ini untuk menerima akses ke API gratis: https://plagiarismsearch.com/account/signup?from =%2Faccount%2Fapi

Setelah Anda mendaftar, buka Profil Saya - Pengaturan API, dan Anda akan melihat Pengguna dan Kunci API disediakan secara pribadi untuk Anda gunakan. Selain itu, Anda juga perlu menggunakan dokumentasi API kami (klik bagian dokumentasi API https://plagiarismsearch.com/docs/ di Profil Anda untuk melihatnya). Berikan akses ke informasi di atas agar pakar teknis Anda dapat mulai menggunakan API kami.

Bagaimana cara kerja API pemeriksaan plagiarisme?

Skema operasi API kami adalah sebagai berikut:

  1. Pengguna membuat laporan (dengan mengirimkan teks, mengunggah file, atau URL publik) https://plagiarismsearch .com/docs/v3/reports/create
  2. Jika saldo Anda aktif – dokumen Anda ditambahkan untuk diperiksa
  3. Jika Anda memeriksa 1000-3000 kata sekaligus, diperlukan waktu 30-60 detik; lebih banyak kata membutuhkan waktu sedikit lebih lama
  4. Setelah memeriksa dokumen, pengguna mendapat permintaan POST`callback_url` https://plagiarismsearch.com/docs /v3/reports/callback-request
  5. Contoh penggunaan API di PHP https://plagiarismsearch.com/files/sample-api.zip

Apakah API memastikan verifikasi teks otomatis secara real-time?

Ya, plagiarisme proses pemeriksaan dilakukan secara real time. Dibutuhkan 1-5 menit untuk memeriksa teks, waktu pemeriksaan plagiarisme tergantung pada ukuran teks.

Apakah mungkin untuk menyiapkan dan mengunduh laporan melalui API?

Ya, Anda dapat mengunduh laporan PDF atau HTML segera setelah pemeriksaan plagiarisme selesai. Semua laporan disimpan dalam database kami, sehingga Anda dapat mengaksesnya kapan saja dan mengunduh https://plagiarismsearch.com/docs/ v3/laporan/tampilan

Apakah mungkin membuat template laporan sendiri?

Tidak. Kami memiliki 2 templat laporan yang tersedia. Anda hanya dapat memasukkan logo perusahaan Anda ke dalam template laporan kami.

Apakah API mengaktifkan bagian tertentu dari verifikasi teks?

Ya, jika Anda berbicara tentang menyertakan atau mengecualikan referensi atau kutipan, memasukkan URL tertentu ke dalam daftar putih.

Apakah mungkin melihat riwayat pemeriksaan teks melalui API?

Ya, semua laporan disimpan di database Anda.

Apakah itu REST API atau plugin? Apakah sinkron atau asinkron?

Kami menyediakan RESTful API. Akses ke dokumentasi API kami ada di sini: https://plagiarismsearch.com/docs/

API kami tidak sinkron. Ketika pemeriksaan plagiarisme selesai, kami mengirimkan web_hook ke callback_url pengguna (https://plagiarismsearch.com/docs/v3 /reports/callback-request).

Apakah ada instruksi tentang cara mengimplementasikan API?

Skema penerapan API yang lebih rumit adalah sebagai berikut:

  1. Daftar dengan situs web kami di sini https://plagiarismsearch.com/account/signup
  2. Pastikan saldo Anda mencukupi aktif atau daftar untuk uji coba API gratis https://plagiarismsearch.com/account/signup?from=%2Faccount %2Fapi
  3. Buka Profil Saya - Pengaturan API, dan Anda akan melihatnya Pengguna dan Kunci API disediakan secara pribadi untuk Anda gunakan https://plagiarismsearch.com/account/api
  4. Kirim file atau teks untuk pemeriksaan plagiarisme menggunakan autentikasi dasar HTTP https://plagiarismsearch.com/docs/v3/reports/create. Berikut ini contoh di CURL:
    curl_setopt($curl, CURLOPT_USERPWD, $apiUser . ':' . $apiKey);
  5. Anda akan menerima tanggapan dengan ID laporan:
    "data": { "id": 100500, "auth_key": "65jdgjhh7h452hjkh45k7535", ... }
  6. Mesin pendeteksi kami menyala proses pemeriksaan plagiarisme.
  7. Setelah pemeriksaan plagiarisme selesai, sistem mengirimkan POST web_hook ke URL yang terhubung ke dokumen yang diserahkan. Jika URL tidak disebutkan, sistem akan mengirimkan POST web_hook ke URL yang ditautkan ke akun pengguna.
  8. Ada cara alternatif untuk mengaturnya status cek plagiarisme, namun tidak direkomendasikan oleh tim kami. Itu untuk memantau status laporan https://plagiarismsearch.com/docs/v3/reports/status dalam interval waktu tertentu, dan periksa apakah status laporannya “Selesai” (status=2), “Kesalahan” (status=-10), atau “Kesalahan server” (status=-11 )
  9. Saat proses plagiarisme pemeriksaan selesai, Anda bisa mendapatkan informasi rinci menggunakan ID laporan. Salah satu contohnya dapat ditemukan di sini: https://plagiarismsearch.com/docs/v3/reports/view

Anda juga dapat menentukan parameter `show_relations` untuk mendapatkan lebih banyak data.

Misalnya,
const RELATIONS_SOURCES = -2;
const RELATIONS_RAW = -1;
konstanta RELATIONS_NONE = 0; // bawaan
konstanta RELATIONS_TREE = 1;

  1. show_relations = -2 => mengembalikan daftar sumber yang diurutkan berdasarkan persen plagiarisme. Lihat kolom respons `data.sources`
  2. show_relations = -1 => mengembalikan semua data laporan. Paragraf, kalimat dan sumber dengan teks highlight. Lihat kolom respons `data.paragraphs`
  3. show_relations = 1 => mengembalikan semua data laporan. Paragraf, kalimat dan sumber dengan teks highlight. Lihat kolom respons `data.paragraphs`

Apakah skrip perlu menunggu hasil tes plagiarisme atau ada fungsi call back yang bisa dipanggil di lain waktu untuk mendapatkan hasil pemrosesan dokumen?

Ada permintaan URL POST callback hook yang kita sambungkan ke pengguna. Anda juga dapat menunjukkan callback_url (khusus) Anda di pengaturan saat Anda mengirimkan dokumen Anda ( https://plagiarismsearch.com/docs/v3/reports/create, https://plagiarismsearch.com/docs/v3/reports/callback-request)

Laporan dapat diunduh dalam beberapa format: (https://plagiarismsearch.com/docs/v3/reports/view ) (Lihat "Respon")

{
 "status": benar,
 "kode": 200,
 "data": {
 "file": "https://plagiarismsearch.com/reports/download/100500?key=54fba6bc7d765cab653f2185a83284a6", // URL laporan pdf publik
 "link": "https://plagiarismsearch.com/reports/100500?key=54fba6bc7d765cab653f2185a83284a6", // URL laporan html publik
 "file": [
 {
 // URL laporan pdf EN publik versi 3
 "url": "https://plagiarismsearch.com/r/download100500?key=54fba6bc7d765cab653f2185a83284a6",
 "ketik": "aplikasi/pdf",
 "bahasa": "id",
 "versi": 3
 },
 {// URL laporan pdf ES publik versi 3
 "url": "https://plagiarismsearch.com/es/r/download/100500?key=54fba6bc7d765cab653f2185a83284a6",
 "ketik": "aplikasi/pdf",
 "bahasa": "es",
 "versi": 3
 },
 {// URL laporan PL pdf publik versi 3
 "url": "https://plagiarismsearch.com/pl/r/download/100500?key=54fba6bc7d765cab653f2185a83284a6",
 "ketik": "aplikasi/pdf",
 "bahasa": "pl",
 "versi": 3
 },
 {// URL laporan pdf EN publik versi 1 (saat ini)
 "url": "https://plagiarismsearch.com/reports/download/100500?key=54fba6bc7d765cab653f2185a83284a6",
 "ketik": "aplikasi/pdf",
 "bahasa": "id",
 "versi": 1
 }
 ]
 }
 }

Bagaimana cara mendapatkan laporan HTML?

Untuk menerima tautan laporan HTML, Anda perlu mengirimkannya DAPATKAN permintaan https://plagiarismsearch.com/api/v3/reports/{id} dimana {id} adalah ID laporan yang ingin Anda terima laporannya. dalam “Respon” data Anda akan menemukan tautan laporan di bidang `data.link`. Juga, di “Respon” Anda akan menemukan 'data.auth_key' yang dapat digunakan untuk menghasilkan 3 kemungkinan varian laporan HTML.

Misalnya, ada 3 kemungkinan varian laporan HTML untuk data.auth_key=65jdgjhh7h452hjkh45k7535

  1. https://plagiarismsearch.com/reports/100500?key=65jdgjhh7h452hjkh45k7535
  2. https://plagiarismsearch.com/r/100500?key=65jdgjhh7h452hjkh45k7535
  3. https://plagiarismsearch.com/reports/lite/100500?key=65jdgjhh7h452hjkh45k7535

Selain itu, Anda dapat membuat tautan laporan dalam 4 bahasa berbeda (EN, ES, PL, RU)

  1. https://plagiarismsearch.com/reports/100500?key=65jdgjhh7h452hjkh45k7535
  2. https://plagiarismsearch.com/es/reports/100500?key=65jdgjhh7h452hjkh45k7535
  3. https://plagiarismsearch.com/pl/reports/100500?key=65jdgjhh7h452hjkh45k7535
  4. https://plagiarismsearch.com/ru/reports/100500?key=65jdgjhh7h452hjkh45k7535

Anda bebas mengombinasikan varian yang berbeda laporan HTML dan bahasa untuk menerima jenis laporan yang diperlukan pada pilihan bahasa.

Skema serupa dapat digunakan untuk menghasilkan laporan PDF tautan (URL ini dapat dilihat di “Respon” -> `data.files`).

Misalnya:

... "file":[ { "url":"https://plagiarismsearch.com/r/download/100500?key=65jdgjhh7h452hjkh45k7535", "ketik":"aplikasi/pdf", "bahasa":"id", "versi":3 }, { "url":"https://plagiarismsearch.com/es/r/download/100500?key=65jdgjhh7h452hjkh45k7535", "ketik":"aplikasi/pdf", "bahasa": "itu", "versi":3 } ] ...

Saya tidak dapat menemukan titik akhir/detail tentang cara membuat token akses.

Token akan ada di akun Anda setelah Anda mendaftar (https://plagiarismsearch.com/account/api)

Hal ini diperlukan untuk mengirimkannya menggunakan Otentikasi HTTP dasar.

Php dengan CURL
// Otentikasi dasar HTTP
curl_setopt($curl, CURLOPT_USERPWD, $apiUser . ':' . $apiKey);

Saya ingin melampirkan file dalam format DOCX, PDF dan PPT untuk diperiksa. Apakah mungkin?

Anda dapat melampirkan file dalam berbagai format: (https://plagiarismsearch.com/docs/v3/reports/create< /a>) string file Atau unggah file untuk diperiksa.
Selain itu, Anda dapat mengirim file dengan nama `file`

Misalnya:
curl -F 'file=@/home/petehouston/hello.txt' https://plagiarismsearch.com/api/v3/reports/create

Bagaimana cara mendapatkan daftar URL tempat teks ditemukan?

Anda harus menggunakan show_relations=1 atau jika Anda hanya memerlukan sumber (link => persen plagiarisme) atau rute panggilan (metode POST) https://plagiarismsearch.com/api/v3/reports /sources/{reportId} (tidak didokumentasikan sekarang) dan gunakan kolom `data.sources`

Bagaimana cara mengecualikan URL saya dari daftar ini?

Anda dapat memanggil rute (metode POST) https://plagiarismsearch.com/api/v3/reports/skip/{reportId} (tidak didokumentasikan sekarang) setelah laporan diperiksa dengan parameter posting

a) POST['url'] = 'https://wikipedia.org' atau

b) POST['source'] = {source.id} (misalnya data.sources[0].id (integer)) atau

c) rangkaian url yang dilewati
POST['url'][] = 'https://wikipedia.org'
POST['urls'][] = 'https://plagiarismsearch.com'

rangkaian id sumber yang dilewati
POST['sources'][] = {source.id}
POST['sources'][] = {source.id2}

Jika Anda memanggil rute dua kali - URL akan disertakan lagi, sehingga memengaruhi persentase plagiarisme secara umum

Untuk penggunaan yang lebih transparan, sebaiknya gunakan rute dengan parameter yang sama seperti dijelaskan di atas.
https://plagiarismsearch.com/api/v3/reports/exclude/{reportId}
https://plagiarismsearch.com/api/v3/reports/include/{reportId}

Kami juga berencana untuk menyelesaikan serangkaian fitur yang memungkinkan pengecualian URL di sini: https://plagiarismsearch.com/api/ v3/laporan/buat

Bagaimana cara menghitung ulang persentase plagiarisme setelah pengecualian?

Tanggapan terhadap permintaan akan mencakup persentase plagiarisme secara umum (yang diubah) data.plagiat

Apa gunanya "filter_references" & "filter_quotes"?

filter_references=1 => kecualikan referensi. Teks referensi tidak berpengaruh pada total persen plagiarisme

filter_quotes=1 => kecualikan kutipan dalam teks. Teks kutipan tidak memiliki bobot terhadap total persen plagiarisme. Penanda kutipan adalah

larik('«', '»'),
larik('"', '"'),
larik('“', '”'),
larik('《', '》'),
susunan('〈', '〉'),
larik('{*', '*}'),

Apakah ada cara untuk mengimplementasikan API melalui CURL?

Berikut panduan yang dapat memudahkan penerapan CURL Anda.

  1. Unggah dokumen untuk pemeriksaan plagiarisme https://plagiarismsearch.com/docs/v3/reports/create
    curl --location --request POST 'https://plagiarismsearch.com/api/v3/reports/create' \
    --header 'Otorisasi: Kombinasi_kunci_pengguna_Anda==' \
    --formulir 'search_web="1"' \
    --formulir 'pencarian_storage="1"' \
    --formulir 'file=@"test_file_plagiarism.txt"'
  2. Lihat laporan https://plagiarismsearch.com/docs/v3/reports/view
    curl --location --request DAPATKAN 'https://plagiarismsearch.com/api/v3/reports/3520470' \
    --header 'Otorisasi: Kombinasi_kunci_pengguna_Anda=='

curl 1

curl 2

Mengapa dokumen berstatus “Tertunda” di Penyimpanan?

Dokumen biasanya berstatus Pending tidak dalam waktu lama, dari 0 hingga 6 menit setelah diunggah atau diunggah ulang. Dokumen langsung ditambahkan ke indeks Penelusuran.

Anda juga dapat memeriksanya di kode program: jika 6 menit berlalu, dokumen berstatus Aktif.

Anda dapat mengetahui status dokumen menggunakan metode seperti ini:

DAPATKAN https://plagiarismsearch.com/api/v3/storage/{id}
Lihat kolom `data.is_in_index`

Bagaimana cara mengunggah dokumen ke penyimpanan melalui API?

Anda dapat mengunggah dokumen Anda melalui API:

POSTING https://plagiarismsearch.com/api/v3/storage/create
dengan parameter, yang mirip dengan https://plagiarismsearch.com/docs/v3/reports/create

Unggah ke penyimpanan

Atau juga, Anda dapat mengunggah dokumen dalam daftar atau arsip menggunakan formulir https://plagiarismsearch.com/storage/upload

Apa saja kemungkinan akun reseller? Bagaimana cara mengintegrasikannya ke dalam sistem saya sendiri?

Fungsi yang ditawarkan oleh akun pengecer kami adalah:

  1. Setiap pengguna baru harus dibuat melalui API (Anda memerlukan login dan kata sandi untuk membuat setiap akun pengguna)
  2. Anda akan mempunyai kesempatan untuk memberikan sejumlah kata tertentu untuk setiap pengguna melalui akun pengecer.

Opsi ini akan membantu memberikan kemungkinan kepada setiap klien untuk menggunakan akunnya secara mandiri, dan Anda akan dapat menambahkan kata-kata yang diperlukan untuk setiap pengguna

Teknis dokumentasi yang diperlukan untuk integrasi:

Anda harus memiliki jenis akun pengecer untuk dapat menciptakan pelanggan. Hubungi kami di services@plagiarismsearch.com ke menerima akses ke kemungkinan penuh akun pengecer.

Buat pelanggan

Untuk membuat pelanggan baru, kirim permintaan POST https://plagiarismsearch.com/api/v3/reseller-customers/create (Email pelanggan wajib diisi)

Misalnya:
curl --lokasi --permintaan POST 'https://plagiarismsearch.com/api/v3/reseller-customers/create' \
--header 'Otorisasi: Dasar
kombinasi_kunci_pengguna_Anda===' \
--form 'email="testusermail@gmail.com"' \
--form 'name="Nama Pengguna"' \
--formulir 'kata sandi="123456"'

Respon

{
 "status": benar,
 "kode":200,
 "data":{
 "id":26784,
 "email":"testusermail@gmail.com",
 "nama":"Nama Pengguna",
 "status":"aktif",
 "kata sandi":"123456"
 },
 "versi":"3.0.0"
 }

Daftar pelanggan

Kirim permintaan DAPATKAN 'https://plagiarismsearch.com/api/v3/reseller-customers' untuk menerima daftar semua pelanggan yang diciptakan.

Misalnya:
curl --lokasi --permintaan DAPATKAN
'https://plagiarismsearch.com/api/v3/reseller-customers' \ --header
'Otorisasi: Dasar kombinasi_kunci_pengguna_Anda=='

Tampilkan saldo

Kirim permintaan DAPATKAN https://plagiarismsearch.com/api/v3/reseller-customers/balance untuk melihat saldo Anda.

Dapatkan saldo Anda

Kirim permintaan DAPATKAN https://plagiarismsearch.com/api/v3/reseller- pelanggan/saldo/{userId} untuk melihat saldo pelanggan tertentu.

Contoh respon keseimbangan:

{
 "status": benar,
 "kode":200,
 "data":{
 "is_solvable": benar,
 "700":{
 "ketik":"Kata-kata",
 "jumlah":6001,
 "kedaluwarsa":1878542044,
 "is_valid": benar,
 "is_solvable": benar
 },
 "300":{
 "type":"Pengiriman",
 "jumlah":4,
 "kedaluwarsa":1720878480,
 "is_valid": benar,
 "is_solvable": benar
 }
 },
 "versi":"3.0.0"
 }

 

Bayar ke saldo pelanggan

Tambahkan jumlah kiriman yang diperlukan atau kata-kata ke akun pelanggan tertentu dengan memasukkan ID pengguna dan memasukkan jumlahkan ke dalam kolom `kata` atau `kiriman` (1 kiriman = 1000 kata).

Misalnya:
curl --lokasi --permintaan POST 'https://plagiarismsearch.com/api/v3/reseller-customers/pay/26784' \
--header 'Otorisasi: Kombinasi_kunci_pengguna_Anda==' \
--bentuk 'kata='1000''

{
 "status": benar,
 "kode":200,
 "data":{
 "id_pembayaran":1171,
 "jumlah":100,
 "ketik":"Kata-kata"
 },
 "versi":"3.0.0"
 }

Bagaimana cara memperbaiki Kesalahan: 400 Permintaan Buruk saat mengirimkan teks karena plagiarisme?

Contoh kesalahan yang mungkin Anda dapatkan saat mengirimkan teks untuk plagiarisme mungkin terlihat seperti:

Metode Permintaan: PUT
Kode Status: 400 Permintaan Buruk

Respon: Tidak ada instance yang tersedia untuk plagiarismsearch.com

API Plagiarisme yang digunakan: https://plagiarismsearch.com/api/v3 /reports/create

Solusi:

Pelanggan harus menggunakan metode POST Http (bukan PUT) seperti pada tangkapan layar

400 Permintaan Buruk

Ada kesalahan autentikasi saat saya menjalankan /report di GET menggunakan modul permintaan di Python.

Anda harus mengirimkan data mengenai otentikasi pada setiap permintaan baru.

Kami menggunakan Otentikasi Dasar, seperti< https://docs.python-requests.org/ en/master/pengguna/autentikasi/
dari permintaan.auth impor HTTPBasicAuth
>>> permintaan.get(' https://plagiarismsearch.com/api/v3/reports/{id}', auth=HTTPBasicAuth('apiUser', 'apiKey'))
// Otentikasi dasar HTTP Php menggunakan CURL
curl_setopt($curl, CURLOPT_USERPWD, $apiUser . ':' . $apiKey);

Apakah Anda memiliki pertanyaan?