Un texte envoyé, un résultat reçu
Le contrat REST ne demande qu’un champ de texte. Il s’intègre donc facilement à un processus de remise de travaux ou de réception éditoriale existant.
API REST / Analyse du plagiat
API de détection de plagiat pour une vérification qui tient compte des sources
Ajoutez l’analyse du plagiat à un produit d’écriture, d’éducation ou d’édition sans envoyer les personnes chargées de la vérification vers un autre outil. Transmettez le texte depuis votre serveur et réintégrez le résultat au processus qu’elles utilisent déjà.
Utilisez la clé depuis un environnement serveur privé.
Requête cURL
curl --request POST \
--url https://api.detecting-ai.com/api/plagiarism/ \
--header "Content-Type: application/json" \
--header "Idempotency-Key: plagiarism-review-001" \
--header "X-API-Key: YOUR_API_KEY" \
--data '{
"text": "Paste the text you want to check."
}'01
Requêtes POST vers /api/plagiarism/
02
Authentification par X-API-Key
03
En-tête Idempotency-Key défini par le client pour reprendre une requête
04
Un seul champ de texte obligatoire
05
Quota de mots propre à la fonctionnalité
Gardez la source dans l’analyse
La similitude est utile lorsque l’on peut comprendre son origine
L’API fournit à votre produit un résultat de plagiat et des données d’usage. Votre interface doit rapprocher ce résultat du passage transmis, du contexte disponible sur la source et des règles pertinentes pour la vérification.
Côté serveur par défaut
Ne placez pas la clé du client dans le navigateur et ne renvoyez que les données du rapport que votre application sait expliquer.
Vérifier avant d’agir
Considérez les ressemblances comme une piste pour vérifier les sources. La citation, l’autorisation et les règles applicables déterminent toujours la signification d’une correspondance.
Contrat de la requête
Le corps de la requête remplit une seule fonction
Envoyez sous forme de chaîne JSON le texte complet à vérifier. Gérez l’analyse des documents, le contrôle des accès et les métadonnées de remise dans votre propre application.
| Champ | Type | Obligatoire | Fonction |
|---|---|---|---|
| text | string | Oui | Le texte que le service de détection de plagiat doit analyser. |
Examinez le résultat renvoyé avant de concevoir l’interface
Le champ result contient l’analyse et words_processed enregistre l’usage. Conservez la réponse brute dans un journal de test privé jusqu’à ce que votre correspondance gère les résultats normaux comme les recherches sans correspondance.
Exemple de réponse
{
"result": "Plagiarism analysis is returned here",
"words_processed": 8
}Parcours d’intégration
Commencez par une boucle de vérification courte et traçable
Une intégration claire maintient un lien entre le texte transmis, l’analyse et l’action de la personne qui le vérifie.
- 1
Créer un appel serveur privé
Conservez la clé API comme un secret et n’acceptez que les textes d’utilisateurs et de systèmes déjà autorisés par votre application.
- 2
Envoyer des documents réalistes
Enregistrez une valeur Idempotency-Key unique, puis testez des essais, articles, annonces ainsi que des passages cités ou référencés réalistes. Ne réutilisez la clé que pour relancer exactement la même requête.
- 3
Construire l’état de vérification
Affichez suffisamment de contexte sur la source et le passage pour qu’une personne comprenne une correspondance avant de la marquer, de la refuser ou de la transmettre.
Cas adaptés
Conçue pour les files où l’originalité compte déjà
L’API doit rester à côté du document et de son historique. Il devient alors plus facile d’examiner une correspondance sans transformer un pourcentage en conclusion définitive.
Une correspondance exige du contexte
Les citations, références, expressions courantes et contenus sous licence peuvent tous créer des ressemblances. Examinez ce qui correspond et pourquoi avant d’agir.
Vérification des devoirs
Placez le résultat de plagiat sur le même écran que le devoir, les citations, le barème et les notes du professeur.
Réception éditoriale
Vérifiez les contributions avant publication et confiez les ressemblances significatives à une personne chargée d’examiner les sources.
Contenu de catalogue
Repérez les descriptions répétées de produits ou d’annonces avant leur ajout à un vaste catalogue.
Contrôles qualité internes
Faites passer les textes autorisés par un backend privé et séparez la clé de l’interface du navigateur.
FAQ de l’API
Des réponses pratiques avant la mise en production
Commencez par une requête côté serveur, consignez la structure de la réponse, puis ajoutez le résultat à votre processus de vérification existant.
Quel point de terminaison utilise l’API de détection de plagiat ?+
Envoyez une requête POST à https://api.detecting-ai.com/api/plagiarism/. Le corps JSON contient un champ text obligatoire. Envoyez X-API-Key et conservez une Idempotency-Key stable afin de pouvoir reprendre les tentatives.
Que contient une réponse réussie ?+
La réponse contient le résultat de plagiat et words_processed. Examinez le résultat dans un environnement de test avant de l’intégrer à votre propre interface de rapport.
Une correspondance signifie-t-elle automatiquement qu’il y a plagiat ?+
Non. Le passage correspondant peut être cité, sous licence, courant, correctement référencé ou appartenir à une bibliographie. Votre processus doit permettre d’examiner la source et le contexte.
Faut-il envoyer la clé API depuis le navigateur ?+
Non. Conservez la clé dans un environnement serveur de confiance et appelez le point de terminaison de plagiat depuis cet environnement. Un paquet JavaScript pour navigateur ou un dépôt public ne peut pas protéger une clé privée.
Comment l’usage du détecteur de plagiat est-il comptabilisé ?+
L’usage se fonde sur le nombre de mots du texte d’entrée et est déduit du quota de plagiat de l’abonnement API. Les réponses réussies incluent words_processed.
Construire la première requête
Testez l’API avec des exemples cités et non cités
Un essai utile comprend un texte original, des expressions courantes, des citations et un passage copié connu afin que votre équipe conçoive les bons états de vérification.