PlagiarismSearch API: Ερωτήσεις και Απαντήσεις

API PS

Το API (Διεπαφή Προγραμματισμού Εφαρμογών) είναι ένα σύνολο διαδικασιών, πρωτοκόλλων και εργαλείων για την κατασκευή λογισμικού. Δημιουργήθηκε για να βοηθήσει οργανισμούς να ελέγχουν μεγάλες ποσότητες κειμένου μέσω του συστήματός τους. Το API μας προσφέρει στους πελάτες μια μοναδική ευκαιρία να ενσωματώσουν το λογισμικό μας στα δικά τους συστήματα ώστε ο έλεγχος λογοκλοπής να γίνει αυτοματοποιημένη διαδικασία. Καθώς η ενσωμάτωση API απαιτεί εξειδικευμένες γνώσεις και συνήθως πραγματοποιείται από τεχνικούς ειδικούς, προκύπτουν πολλές ερωτήσεις σχετικά με τα ιδιαίτερα χαρακτηριστικά του για να διασφαλιστεί η αποδοτική λειτουργία. Στο άρθρο αυτό συγκεντρώσαμε τις πιο δημοφιλείς ερωτήσεις-απαντήσεις σχετικά με την απόδοση του API μας και λύσεις στα πιο συχνά προβλήματα που αντιμετωπίζουν οι πελάτες μας κατά τη διαδικασία ενσωμάτωσης.

Επιπλέον, η ενσωμάτωση του API προσφέρει στους πελάτες μας τη δυνατότητα να αξιοποιήσουν τον προσωπικό τους Αποθηκευτικό Χώρο. Οι πελάτες μπορούν να ανεβάσουν τα δικά τους αρχεία στο σύστημα Αποθήκευσης και να αποθηκεύσουν τα κείμενα που ελέγχθηκαν για λογοκλοπή μέσω του API μας, δημιουργώντας έτσι έναν ατομικό Αποθηκευτικό Χώρο. Ο έλεγχος κειμένων για λογοκλοπή έναντι του προσωπικού αποθηκευτικού χώρου επιτρέπει στους πελάτες μας να ανιχνεύσουν και να αποτρέψουν την αυτολογοκλοπή. Διαβάστε περισσότερα για τις λειτουργίες του προσωπικού χώρου αποθήκευσης στον οδηγό μας https://plagiarismsearch.com/plagiarism-database.

Ποιες λειτουργίες είναι διαθέσιμες μέσω του API;

  1. Έλεγχος κειμένων και εγγράφων για λογοκλοπή
  2. Πρόσβαση σε αναφορές λογοκλοπής (ιστορικό ελέγχων)
  3. Δυνατότητα αποθήκευσης βάσης δεδομένων του πελάτη και προβολή εγγράφων στον αποθηκευτικό χώρο
  4. Οι μεταπωλητές έχουν τη δυνατότητα να δημιουργήσουν πολλαπλούς λογαριασμούς χρηστών και να τους αναθέσουν τον κατάλληλο αριθμό ελέγχων/λέξεων. Αυτές οι επιλογές επιτρέπουν σε κάθε παραπομπή να χρησιμοποιεί ανεξάρτητα τον λογαριασμό της.

Πώς μπορώ να αποκτήσω πρόσβαση στο API;

Μπορείτε να αποκτήσετε πρόσβαση στο API μας δωρεάν για 30 ημέρες. Θα έχετε επίσης 100 ελέγχους και προσωπικό χώρο αποθήκευσης για να δοκιμάσετε όλα τα πλεονεκτήματα της υπηρεσίας μας. Παρακαλούμε εγγραφείτε μέσω του συνδέσμου: https://plagiarismsearch.com/gr/account/signup?from=%2Faccount%2Fapi

Αφού εγγραφείτε, μεταβείτε στο Προφίλ Μου - Ρυθμίσεις API, και θα δείτε το API User και το Key που παρέχονται προσωπικά για εσάς. Επίσης, θα χρειαστεί να χρησιμοποιήσετε την τεκμηρίωση του API μας (κάντε κλικ στην ενότητα τεκμηρίωσης API https://plagiarismsearch.com/docs/ στο Προφίλ σας για να τη δείτε). Δώστε πρόσβαση σε αυτές τις πληροφορίες στον τεχνικό σας ειδικό για να ξεκινήσετε να χρησιμοποιείτε το API μας.

Πώς λειτουργεί το API ελέγχου λογοκλοπής;

Το σχήμα λειτουργίας του API μας έχει ως εξής:

  1. Ο χρήστης δημιουργεί μια αναφορά (με υποβολή κειμένου, ανέβασμα αρχείου ή δημόσιο URL) https://plagiarismsearch.com/docs/v3/reports/create
  2. Αν το υπόλοιπό σας είναι ενεργό – το έγγραφό σας προστίθεται για έλεγχο
  3. Αν ελέγξετε 1000-3000 λέξεις ταυτόχρονα, μπορεί να διαρκέσει 30-60 δευτερόλεπτα· περισσότερες λέξεις χρειάζονται λίγο παραπάνω χρόνο
  4. Μετά τον έλεγχο, ο χρήστης λαμβάνει αίτημα POST `callback_url` https://plagiarismsearch.com/docs/v3/reports/callback-request
  5. Δείγμα χρήσης του API σε PHP https://plagiarismsearch.com/files/sample-api.zip

Το API πραγματοποιεί αυτόματο έλεγχο σε πραγματικό χρόνο;

Ναι, η διαδικασία ελέγχου λογοκλοπής πραγματοποιείται σε πραγματικό χρόνο. Διαρκεί 1-5 λεπτά για να ελεγχθεί ένα κείμενο, ανάλογα με το μέγεθός του.

Είναι δυνατή η δημιουργία και λήψη αναφορών μέσω του API;

Ναι, μπορείτε να κατεβάσετε αναφορές σε PDF ή HTML αμέσως μετά την ολοκλήρωση του ελέγχου. Όλες οι αναφορές αποθηκεύονται στη βάση δεδομένων μας, ώστε να έχετε πρόσβαση και να τις κατεβάσετε ανά πάσα στιγμή https://plagiarismsearch.com/docs/v3/reports/view

Μπορώ να δημιουργήσω το δικό μου πρότυπο αναφοράς;

Όχι. Διαθέτουμε 2 πρότυπα αναφορών. Μπορείτε μόνο να προσθέσετε το λογότυπο της εταιρείας σας στο πρότυπο αναφοράς μας.

Το API επιτρέπει τον έλεγχο συγκεκριμένων μερών του κειμένου;

Ναι, εάν αναφέρεστε σε συμπερίληψη ή εξαίρεση βιβλιογραφικών αναφορών, ή προσθήκη συγκεκριμένων URL στη λίστα επιτρεπόμενων.

Είναι δυνατή η προβολή του ιστορικού ελέγχου κειμένου μέσω του API;

Ναι, όλες οι αναφορές αποθηκεύονται στη βάση δεδομένων σας.

Είναι REST API ή πρόσθετο; Είναι σύγχρονο ή ασύγχρονο;

Παρέχουμε RESTful API. Η πρόσβαση στην τεκμηρίωση του API μας είναι εδώ: https://plagiarismsearch.com/docs/

Το API μας είναι ασύγχρονο. Όταν ολοκληρωθεί ο έλεγχος λογοκλοπής, στέλνουμε ένα web_hook στο callback_url του χρήστη (https://plagiarismsearch.com/docs/v3/reports/callback-request).

Υπάρχει κάποια οδηγία για την υλοποίηση του API;

Ένα πιο αναλυτικό σχήμα υλοποίησης του API είναι το εξής:

  1. Εγγραφείτε στον ιστότοπό μας εδώ https://plagiarismsearch.com/gr/account/signup
  2. Βεβαιωθείτε ότι το υπόλοιπό σας είναι ενεργό ή εγγραφείτε για μια δωρεάν δοκιμή API https://plagiarismsearch.com/account/signup?from=%2Faccount%2Fapi
  3. Μεταβείτε στο Προφίλ μου - Ρυθμίσεις API, και θα δείτε Όνομα Χρήστη API και Κλειδί που σας παρέχονται προσωπικά https://plagiarismsearch.com/gr/account/api
  4. Στείλτε ένα αρχείο ή κείμενο για έλεγχο λογοκλοπής χρησιμοποιώντας HTTP basic authentication https://plagiarismsearch.com/docs/v3/reports/create. Εδώ είναι ένα παράδειγμα σε CURL:
    curl_setopt($curl, CURLOPT_USERPWD, $apiUser . ':' . $apiKey);
  5. Θα λάβετε απάντηση με το ID της αναφοράς:
    "data": { "id": 100500, "auth_key": "65jdgjhh7h452hjkh45k7535", ... }
  6. Η μηχανή ανίχνευσης ξεκινά τη διαδικασία ελέγχου λογοκλοπής.
  7. Αφού ολοκληρωθεί ο έλεγχος λογοκλοπής, το σύστημα στέλνει POST web_hook στη διεύθυνση URL που συνδέεται με το υποβληθέν έγγραφο. Σε περίπτωση που δεν έχει δηλωθεί URL, το σύστημα στέλνει POST web_hook στη διεύθυνση URL που συνδέεται με τον λογαριασμό του χρήστη.
  8. Υπάρχει εναλλακτικός τρόπος για να ορίσετε την κατάσταση του ελέγχου λογοκλοπής, αν και δεν συνιστάται από την ομάδα μας. Είναι η παρακολούθηση της κατάστασης της αναφοράς https://plagiarismsearch.com/docs/v3/reports/status σε τακτά χρονικά διαστήματα, και να ελέγχετε αν η κατάσταση της αναφοράς είναι “Ολοκληρώθηκε” (status=2), “Σφάλμα” (status=-10), ή “Σφάλμα διακομιστή” (status=-11)
  9. Όταν ολοκληρωθεί η διαδικασία ελέγχου λογοκλοπής, μπορείτε να λάβετε λεπτομερείς πληροφορίες χρησιμοποιώντας το ID της αναφοράς. Ένα από τα παραδείγματα μπορείτε να δείτε εδώ: https://plagiarismsearch.com/docs/v3/reports/view

Μπορείτε επίσης να καθορίσετε την παράμετρο `show_relations` για να λάβετε περισσότερα δεδομένα.

Για παράδειγμα,
const RELATIONS_SOURCES = -2;
const RELATIONS_RAW = -1;
const RELATIONS_NONE = 0; // προεπιλογή
const RELATIONS_TREE = 1;

  1. show_relations = -2 => επιστρέφει λίστα πηγών ταξινομημένων κατά ποσοστό λογοκλοπής. Δείτε το πεδίο απόκρισης `data.sources`
  2. show_relations = -1 => επιστρέφει όλα τα δεδομένα της αναφοράς. Παράγραφοι, προτάσεις και πηγές με επισημασμένο κείμενο. Δείτε το πεδίο απόκρισης `data.paragraphs`
  3. show_relations = 1 => επιστρέφει όλα τα δεδομένα της αναφοράς. Παράγραφοι, προτάσεις και πηγές με επισημασμένο κείμενο. Δείτε το πεδίο απόκρισης `data.paragraphs`

Χρειάζεται τα σενάρια να περιμένουν το αποτέλεσμα του τεστ λογοκλοπής ή υπάρχει κάποια συνάρτηση callback που μπορεί να καλεστεί αργότερα για να ληφθεί το αποτέλεσμα επεξεργασίας του εγγράφου;

Υπάρχει αίτημα POST callback hook URL που συνδέουμε με τον χρήστη. Μπορείτε επίσης να καθορίσετε τη δική σας (προσαρμοσμένη) διεύθυνση callback_url στις ρυθμίσεις όταν υποβάλλετε το έγγραφο ( https://plagiarismsearch.com/docs/v3/reports/create, https://plagiarismsearch.com/docs/v3/reports/callback-request)

Η αναφορά μπορεί να ληφθεί σε διάφορες μορφές: (https://plagiarismsearch.com/docs/v3/reports/view) (Δείτε "Απόκριση")

{
   "status": true,
   "code": 200,
   "data": {
      "file": "https://plagiarismsearch.com/reports/download/100500?key=54fba6bc7d765cab653f2185a83284a6", // public pdf report URL
      "link": "https://plagiarismsearch.com/reports/100500?key=54fba6bc7d765cab653f2185a83284a6", // public html report URL
      "files": [
        {
            // public EN pdf report URL version 3
            "url": "https://plagiarismsearch.com/r/download100500?key=54fba6bc7d765cab653f2185a83284a6",
            "type": "application/pdf",
            "language": "en",
            "version": 3
         },
         { // public ES pdf report URL version 3
            "url": "https://plagiarismsearch.com/es/r/download/100500?key=54fba6bc7d765cab653f2185a83284a6",
            "type": "application/pdf",
            "language": "es",
            "version": 3
         },
         { // public PL pdf report URL version 3
            "url": "https://plagiarismsearch.com/pl/r/download/100500?key=54fba6bc7d765cab653f2185a83284a6",
            "type": "application/pdf",
            "language": "pl",
            "version": 3
         },
         { // public EN pdf report URL version 1 (current)
            "url": "https://plagiarismsearch.com/reports/download/100500?key=54fba6bc7d765cab653f2185a83284a6",
            "type": "application/pdf",
            "language": "en",
            "version": 1
         }
      ]
   }
}

Πώς μπορώ να λάβω μια αναφορά HTML;

Για να λάβετε σύνδεσμο αναφοράς HTML πρέπει να στείλετε αίτημα GET στο https://plagiarismsearch.com/api/v3/reports/{id} όπου το {id} είναι το αναγνωριστικό της αναφοράς που θέλετε να λάβετε. Στα δεδομένα της “Απόκρισης” θα βρείτε τον σύνδεσμο της αναφοράς στο πεδίο `data.link`. Επίσης, στην “Απόκριση” θα βρείτε το `data.auth_key`, το οποίο μπορείτε να χρησιμοποιήσετε για να δημιουργήσετε 3 δυνατές παραλλαγές HTML αναφορών.

Για παράδειγμα, υπάρχουν 3 δυνατές παραλλαγές HTML αναφορών για το 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

Επιπλέον, μπορείτε να δημιουργήσετε συνδέσμους αναφοράς σε 4 διαφορετικές γλώσσες (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

Είστε ελεύθεροι να συνδυάσετε διαφορετικές παραλλαγές HTML αναφορών και γλωσσών για να λάβετε τον τύπο αναφοράς που χρειάζεστε στη γλώσσα της επιλογής σας.

Παρόμοιο σχήμα μπορεί να χρησιμοποιηθεί για δημιουργία συνδέσμου PDF αναφοράς (αυτά τα URL εμφανίζονται στην “Απόκριση” -> `data.files`).

Για παράδειγμα:

...
"files":[
   {
      "url":"https://plagiarismsearch.com/r/download/100500?key=65jdgjhh7h452hjkh45k7535",
      "type":"application/pdf",
      "language":"en",
      "version":3
   },
   {
      "url":"https://plagiarismsearch.com/es/r/download/100500?key=65jdgjhh7h452hjkh45k7535",
      "type":"application/pdf",
      "language":"es",
      "version":3
   }
]
...

Δεν μπορώ να βρω τελικά σημεία ή λεπτομέρειες για το πώς να δημιουργήσω access tokens.

Το διακριτικό θα βρίσκεται στον λογαριασμό σας μετά την εγγραφή (https://plagiarismsearch.com/gr/account/api)

Είναι απαραίτητο να το μεταδώσετε χρησιμοποιώντας HTTP βασικό έλεγχο ταυτότητας.

Php με CURL
// HTTP βασικός έλεγχος ταυτότητας
curl_setopt($curl, CURLOPT_USERPWD, $apiUser . ':' . $apiKey);

Θα ήθελα να επισυνάψω αρχεία σε DOCX, PDF και PPT για έλεγχο. Είναι δυνατόν;

Μπορείτε να επισυνάψετε αρχεία σε πολλαπλές μορφές: (https://plagiarismsearch.com/docs/v3/reports/create) είτε ως συμβολοσειρά είτε με αποστολή αρχείου για έλεγχο.
Επιπλέον, μπορείτε να στείλετε αρχεία με όνομα `file`

Για παράδειγμα:
curl -F 'file=@/home/petehouston/hello.txt' https://plagiarismsearch.com/api/v3/reports/create

Πώς μπορώ να λάβω τη λίστα των URL όπου βρέθηκε το κείμενο;

Πρέπει να χρησιμοποιήσετε show_relations=1 ή, αν χρειάζεστε μόνο τις πηγές (σύνδεσμοι => ποσοστό λογοκλοπής), να καλέσετε τη διαδρομή (μέθοδος POST) https://plagiarismsearch.com/api/v3/reports/sources/{reportId} (δεν έχει τεκμηριωθεί ακόμα) και να χρησιμοποιήσετε το πεδίο `data.sources`

Πώς μπορώ να εξαιρέσω το URL μου από αυτήν τη λίστα;

Μπορείτε να καλέσετε τη διαδρομή (μέθοδος POST) https://plagiarismsearch.com/api/v3/reports/skip/{reportId} (δεν έχει τεκμηριωθεί ακόμα) μετά τον έλεγχο της αναφοράς με παραμέτρους POST

α) POST['url'] = 'https://wikipedia.org' ή

β) POST['source'] = {source.id} (για παράδειγμα data.sources[0].id (ακέραιος)) ή

γ) πίνακας με URLs προς παράλειψη
POST['urls'][] = 'https://wikipedia.org'
POST['urls'][] = 'https://plagiarismsearch.com'

πίνακας με source ids προς παράλειψη
POST['sources'][] = {source.id}
POST['sources'][] = {source.id2}

Αν καλέσετε τη διαδρομή δύο φορές - τα URLs θα συμπεριληφθούν ξανά, επηρεάζοντας το συνολικό ποσοστό λογοκλοπής

Για πιο διαφανή χρήση, είναι καλύτερο να χρησιμοποιείτε διαδρομές με τις ίδιες παραμέτρους όπως περιγράφηκαν παραπάνω.
https://plagiarismsearch.com/api/v3/reports/exclude/{reportId}
https://plagiarismsearch.com/api/v3/reports/include/{reportId}

Σχεδιάζουμε επίσης να ολοκληρώσουμε ένα σετ λειτουργιών που θα επιτρέπει την εξαίρεση URL εδώ: https://plagiarismsearch.com/api/v3/reports/create

Πώς μπορώ να επανυπολογίσω το ποσοστό λογοκλοπής μετά τον αποκλεισμό;

Η απάντηση στο αίτημα θα περιλαμβάνει το γενικό (τροποποιημένο) ποσοστό λογοκλοπής data.plagiat

Σε τι χρησιμεύουν τα "filter_references" & "filter_quotes";

filter_references=1 => αποκλείει τις βιβλιογραφικές αναφορές. Το κείμενο των αναφορών δεν επηρεάζει το συνολικό ποσοστό λογοκλοπής

filter_quotes=1 => αποκλείει τις ενδοκειμενικές παραπομπές. Το κείμενο των παραπομπών δεν επηρεάζει το συνολικό ποσοστό λογοκλοπής. Οι δείκτες παραπομπών είναι

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

Υπάρχει τρόπος να υλοποιηθεί το API μέσω CURL;

Ακολουθούν οι οδηγίες που μπορούν να διευκολύνουν την υλοποίηση CURL.

  1. Ανέβασμα εγγράφου για έλεγχο λογοκλοπής https://plagiarismsearch.com/docs/v3/reports/create
    curl --location --request POST 'https://plagiarismsearch.com/api/v3/reports/create' \
    --header 'Authorization: Basic your_user_key_combination==' \
    --form 'search_web="1"' \
    --form 'search_storage="1"' \
    --form 'file=@"test_file_plagiarism.txt"'
  2. Προβολή αναφοράς https://plagiarismsearch.com/docs/v3/reports/view
    curl --location --request GET 'https://plagiarismsearch.com/api/v3/reports/3520470' \
    --header 'Authorization: Basic your_user_key_combination=='

curl 1

curl 2

Γιατί το έγγραφο έχει κατάσταση “Pending” στην Αποθήκευση;

Το έγγραφο παραμένει συνήθως σε κατάσταση Pending για μικρό χρονικό διάστημα, από 0 έως 6 λεπτά αφού ανέβει ή επαναφορτωθεί. Το έγγραφο προστίθεται άμεσα στον δείκτη Αναζήτησης.

Μπορείτε επίσης να το ελέγξετε στον κώδικα του προγράμματος: αν περάσουν 6 λεπτά, το έγγραφο έχει κατάσταση Active.

Είναι δυνατό να ελέγξετε την κατάσταση του εγγράφου με την εξής μέθοδο:

GET https://plagiarismsearch.com/api/v3/storage/{id}
Δείτε το πεδίο `data.is_in_index`

Πώς να ανεβάσετε έγγραφα στην αποθήκευση μέσω API;

Μπορείτε να ανεβάσετε τα έγγραφά σας μέσω API:

POST https://plagiarismsearch.com/api/v3/storage/create
με παραμέτρους, παρόμοιες με https://plagiarismsearch.com/docs/v3/reports/create

Upload to storage

Εναλλακτικά, μπορείτε να ανεβάσετε έγγραφα σε λίστα ή αρχείο μέσω της φόρμας https://plagiarismsearch.com/storage/upload

Ποιες είναι οι δυνατότητες ενός λογαριασμού μεταπωλητή; Πώς μπορώ να τον ενσωματώσω στο δικό μου σύστημα;

Οι λειτουργίες που προσφέρει ο λογαριασμός μεταπωλητή είναι:

  1. Κάθε νέος χρήστης πρέπει να δημιουργείται μέσω API (θα χρειαστείτε όνομα χρήστη και κωδικό για να δημιουργήσετε κάθε λογαριασμό)
  2. Θα έχετε τη δυνατότητα να διαθέσετε συγκεκριμένο αριθμό λέξεων για κάθε χρήστη μέσω του λογαριασμού μεταπωλητή.

Αυτές οι επιλογές θα δώσουν τη δυνατότητα σε κάθε πελάτη να χρησιμοποιεί τον λογαριασμό του ανεξάρτητα, και θα μπορείτε να προσθέτετε λέξεις που είναι απαραίτητες για κάθε χρήστη.

Τεχνική τεκμηρίωση απαραίτητη για την ενσωμάτωση:

Χρειάζεται να έχετε έναν τύπο λογαριασμού μεταπωλητή για να μπορείτε να δημιουργείτε πελάτες. Επικοινωνήστε μαζί μας στο services@plagiarismsearch.com για να λάβετε πρόσβαση σε όλες τις δυνατότητες του λογαριασμού μεταπωλητή.

Δημιουργία πελάτη

Για να δημιουργήσετε έναν νέο πελάτη, στείλτε αίτημα POST https://plagiarismsearch.com/api/v3/reseller-customers/create (Το email του πελάτη είναι απαιτούμενο πεδίο)

Για παράδειγμα:
curl --location --request POST 'https://plagiarismsearch.com/api/v3/reseller-customers/create' \
--header 'Authorization: Basic
your_user_key_combination===' \
--form 'email="testusermail@gmail.com"' \
--form 'name="User Name"' \
--form 'password="123456"'

Απάντηση

{
   "status":true,
   "code":200,
   "data":{
      "id":26784,
      "email":"testusermail@gmail.com",
      "name":"User Name",
      "status":"active",
      "password":"123456"
   },
   "version":"3.0.0"
}

Λίστα πελατών

Στείλτε αίτημα GET 'https://plagiarismsearch.com/api/v3/reseller-customers' για να λάβετε τη λίστα με όλους τους πελάτες που δημιουργήθηκαν.

Για παράδειγμα:
curl --location --request GET
'https://plagiarismsearch.com/api/v3/reseller-customers' \ --header
'Authorization: Basic your_user_key_combination=='

Εμφάνιση υπολοίπων

Στείλτε αίτημα GET https://plagiarismsearch.com/api/v3/reseller-customers/balance για να δείτε το υπόλοιπό σας.

Λήψη υπολοίπου

Στείλτε αίτημα GET https://plagiarismsearch.com/api/v3/reseller-customers/balance/{userId} για να δείτε το υπόλοιπο ενός συγκεκριμένου πελάτη.

Παράδειγμα απάντησης υπολοίπου:

{
   "status":true,
   "code":200,
   "data":{
      "is_solvable":true,
      "700":{
         "type":"Words",
         "amount":6001,
         "expired":1878542044,
         "is_valid":true,
         "is_solvable":true
      },
      "300":{
         "type":"Submissions",
         "amount":4,
         "expired":1720878480,
         "is_valid":true,
         "is_solvable":true
      }
   },
   "version":"3.0.0"
}

 

Πληρωμή στο υπόλοιπο του πελάτη

Προσθέστε τον απαραίτητο αριθμό υποβολών ή λέξεων στο λογαριασμό ενός συγκεκριμένου πελάτη εισάγοντας το αναγνωριστικό χρήστη και την ποσότητα στο πεδίο `words` ή `submissions` (1 υποβολή = 1000 λέξεις).

Για παράδειγμα:
curl --location --request POST 'https://plagiarismsearch.com/api/v3/reseller-customers/pay/26784' \
--header 'Authorization: Basic your_user_key_combination==' \
--form 'words="1000"'

{
   "status":true,
   "code":200,
   "data":{
      "payment_id":1171,
      "amount":100,
      "type":"Words"
   },
   "version":"3.0.0"
}

Πώς να διορθώσετε το Σφάλμα: 400 Bad Request κατά την υποβολή κειμένου για έλεγχο λογοκλοπής;

Το σφάλμα που μπορεί να λάβετε κατά την υποβολή κειμένου για έλεγχο λογοκλοπής μπορεί να μοιάζει με:

Μέθοδος αιτήματος: PUT
Κωδικός κατάστασης: 400 Bad Request

Απάντηση: No instances available for plagiarismsearch.com

Χρησιμοποιούμενο Plagiarism API: https://plagiarismsearch.com/api/v3/reports/create 

Λύση:

Ο πελάτης θα πρέπει να χρησιμοποιεί τη μέθοδο POST Http (και όχι PUT) όπως στο στιγμιότυπο οθόνης

400 Bad Request

Υπάρχει σφάλμα ταυτοποίησης όταν εκτελώ το /report με GET χρησιμοποιώντας τη βιβλιοθήκη request στην Python.

Πρέπει να στείλετε τα δεδομένα ταυτοποίησης σε κάθε νέο αίτημα.

Χρησιμοποιούμε Βασικό Έλεγχο Ταυτότητας (Basic Authentication), όπως στο:
https://docs.python-requests.org/en/master/user/authentication/
from requests.auth import HTTPBasicAuth
>>> requests.get(' https://plagiarismsearch.com/api/v3/reports/{id}', auth=HTTPBasicAuth('apiUser', 'apiKey'))
// Βασικός έλεγχος ταυτότητας HTTP στην Php με χρήση CURL
curl_setopt($curl, CURLOPT_USERPWD, $apiUser . ':' . $apiKey);