Entrada de texto, salida de resultado
El contrato REST necesita un campo de texto. Eso hace que sea sencillo agregarlo a un envío o canal editorial existente.
API REST / análisis de plagio
API del detector de plagio para revisión basada en la fuente
Añade el análisis de plagio a un producto educativo o editorial sin obligar a los revisores a usar otra herramienta. Envía el texto desde tu servidor y devuelve el resultado al flujo que ya utilizan.
Usa la clave de un entorno de servidor privado.
Solicitud 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
Solicitudes POST a /api/plagiarism/
02
Autenticación mediante X-API-Key
03
Idempotency-Key del cliente para reintentos seguros
04
Un campo de texto obligatorio
05
Saldo de palabras específico de la función
Mantén la fuente dentro de la revisión
La similitud es útil cuando el revisor puede examinar por qué aparece
La API proporciona a tu producto un resultado de plagio y datos de uso. Tu interfaz debe combinarlo con el fragmento enviado, el contexto disponible de la fuente y las reglas que necesita el revisor.
Lado del servidor por defecto
Mantén la clave del cliente fuera del navegador y devuelve solo los datos del informe que tu aplicación esté preparada para explicar.
Revisión antes de actuar
Trata la coincidencia como una pista para comprobar la fuente. La cita, el permiso y las políticas determinan lo que significa.
Contrato de la solicitud
El cuerpo de la solicitud tiene una única función
Envía como string JSON todo el texto que quieras comprobar. Gestiona en tu aplicación el análisis de documentos, el control de acceso y cualquier metadato del envío.
| Campo | Tipo | Requerido | Qué hace |
|---|---|---|---|
| text | string | Sí | El texto que quieres que analice el servicio de plagio. |
Examina el resultado antes de diseñar la interfaz
El campo de resultado contiene el análisis y words_processed registra el uso. Guarda la respuesta sin procesar en un registro de prueba privado hasta que tu mapeo gestione correctamente tanto los resultados con coincidencias como los vacíos.
Ejemplo de respuesta
{
"result": "Plagiarism analysis is returned here",
"words_processed": 8
}Flujo de integración
Empieza con un proceso de revisión pequeño y rastreable
Una integración clara mantiene conectados el texto enviado, el análisis y la acción del revisor.
- 1
Crea una llamada privada desde el servidor
Guarda la clave de API como secreto y acepta texto solo de usuarios y sistemas que tu aplicación ya autorice.
- 2
Prueba documentos realistas
Conserva un Idempotency-Key único y prueba ensayos, artículos, listados y materiales realistas, con y sin citas. Reutiliza la clave solo para repetir exactamente la misma solicitud.
- 3
Crea el estado de revisión
Muestra suficiente contexto de la fuente y del fragmento para que una persona entienda la coincidencia antes de marcarla, rechazarla o derivarla.
Casos de uso adecuados
Diseñado para colas donde la originalidad ya importa
La API debe estar junto al documento y su historial. Así es más fácil investigar una coincidencia sin convertir un porcentaje en un veredicto.
Una coincidencia necesita contexto
El texto citado, las referencias, las frases estándar y el material con licencia pueden crear superposiciones. Revisa qué coincidió y por qué antes de tomar medidas.
Revisión de tarea
Trae el resultado de plagio a la misma pantalla que el envío, los detalles de la cita, la rúbrica y las notas del instructor.
Recepción editorial
Comprueba el contenido recibido antes de publicarlo y envía las coincidencias relevantes a un editor para que revise las fuentes.
Contenido del catálogo
Revisa descripciones repetidas de productos o publicaciones de marketplaces antes de añadirlas a un catálogo grande.
Controles internos de calidad
Procesa el texto autorizado en un backend privado y mantén la clave separada de la interfaz del navegador.
Preguntas frecuentes sobre la API
Respuestas prácticas antes del lanzamiento
Empieza con una solicitud desde el servidor, registra la estructura de la respuesta y después añade el resultado a tu flujo de revisión.
¿Qué endpoint usa la API del detector de plagio?+
Envía una solicitud POST a https://api.detecting-ai.com/api/plagiarism/. El cuerpo JSON contiene el campo obligatorio text. Envía X-API-Key y conserva un Idempotency-Key estable para poder reintentar con seguridad.
¿Qué contiene una respuesta exitosa?+
La respuesta contiene el resultado del plagio y words_processed. Examínala en un entorno de prueba antes de asignarla a tu interfaz de informes.
¿Una coincidencia significa automáticamente plagio?+
No. El texto coincidente puede estar citado, autorizado, ser una frase común o formar parte de una bibliografía. Tu flujo debe permitir que un revisor examine la fuente y el contexto.
¿Se debe enviar la clave de API desde el navegador?+
No. Guarda la clave en un servidor de confianza y llama al endpoint de plagio desde allí. Un paquete del navegador o un repositorio público no pueden proteger una clave privada.
¿Cómo se cuenta el uso de plagio?+
El uso se basa en el número de palabras de entrada y se descuenta del saldo de plagio de la suscripción de la API. Las respuestas correctas incluyen words_processed.
Prepara la primera solicitud
Prueba la API con muestras citadas y sin citar
Una prueba útil incluye texto original, frases comunes, citas y un fragmento copiado conocido para que tu equipo pueda diseñar los estados de revisión adecuados.