REST API / AI-detectie

AI-detector-API voor signalen die klaar zijn voor beoordeling

Stuur tekst naar één HTTPS-endpoint en voeg AI-tekstanalyse toe aan je eigen product. Detector v3 retourneert gestructureerde gegevens die je team in de juiste context kan beoordelen, opslaan en toelichten.

Gebruik de sleutel uit een privéserveromgeving.

cURL-verzoek
curl --request POST \
  --url https://api.detecting-ai.com/api/detect/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: detector-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to analyze.",
    "version": "v3"
  }'
01

POST-verzoeken naar /api/detect/

02

Authenticatie met X-API-Key

03

Idempotency-Key van de client voor veilige nieuwe pogingen

04

Detector v3 voor nieuwe integraties

05

JSON-verzoek en -antwoord

Gebouwd voor echte beoordelingsprocessen

Een compact API-contract met ruimte voor een zorgvuldig oordeel

De integratie blijft eenvoudig: je server verzendt de tekst, de detector analyseert deze en je interface beslist hoe het resultaat wordt gepresenteerd. Die scheiding maakt de workflow gemakkelijker te testen en houdt de uiteindelijke beslissing bij een persoon.

Eén doelgericht endpoint

Voeg een tekstreeks en detectorversie toe aan een JSON-verzoek. Voor de basisintegratie hoef je geen aparte SDK bij te houden.

Gestructureerde uitvoer

Lees de detectordetails, versie en het aantal verwerkte woorden uit het antwoord in plaats van een webpagina uit te lezen.

Menselijke beoordeling blijft zichtbaar

Gebruik het signaal om passages en zaken te prioriteren. Maak van één modelscore geen automatische beschuldiging of afwijzing.

Verzoekcontract

Twee velden zijn voldoende om te starten

Verzend UTF-8-tekst als JSON en kies bewust de detectorversie. Nieuwe integraties moeten v3 gebruiken.

VeldTypeVereistWat het doet
textstringJaDe tekst die je door de detector wilt laten analyseren.
versionstringJaDetectorversie. Gebruik v3 voor een nieuwe integratie.

Bewaar tijdens de ontwikkeling het volledige antwoord

Log eerst het volledige JSON-antwoord in een beveiligde testomgeving. Zodra het contract duidelijk is, koppel je alleen de velden die je product gebruikt en bewaar je het aantal verwerkte woorden voor de gebruiksregistratie.

Voorbeeldantwoord
{
  "success": true,
  "data": {
    "details": {
      "result": "Detector analysis is returned here"
    },
    "version": "v3",
    "words_processed": 8
  }
}

Integratiestappen

Van API-sleutel tot een bruikbaar resultaat

Bouw het verzoek eerst op je server. Voeg de productinterface pas toe nadat het succesvolle scenario en de foutgevallen duidelijk zijn.

  1. 1

    Bereid de sleutel voor, bewaar deze en activeer deze

    Maak een sleutel aan in het dashboard, kopieer de eenmalig getoonde waarde naar het geheimenbeheer op je server, controleer of deze is opgeslagen en activeer de sleutel. Na activering wordt de volledige waarde niet opnieuw weergegeven.

  2. 2

    Stuur een representatief voorbeeld

    Stuur realistische tekst in een POST-verzoek met versie v3 en bewaar vóór verzending een unieke Idempotency-Key. Gebruik die sleutel alleen opnieuw voor een exacte nieuwe poging.

  3. 3

    Presenteer het bewijsmateriaal zorgvuldig

    Zet het gestructureerde antwoord om in een duidelijke beoordelingsweergave, met ruimte om de tekst en context te controleren.

Geschikte toepassingen

Handig overal waar tekst al door een beoordelingswachtrij gaat

De API werkt het beste als input voor een bestaand besluitvormingsproces. Het moet mensen helpen beslissen waar ze moeten zoeken, en niet de beslissing voor hen nemen.

Detectie is geen bewijs van auteurschap

Modellen kunnen fouten maken, vooral bij korte, sterk bewerkte, vertaalde of formulematig geschreven tekst. Laat beslissingen met gevolgen nooit volledig automatisch nemen.

Redactionele intake

Voeg een auteurschapssignaal toe aan ingediende concepten en stuur ongebruikelijke gevallen door naar een redacteur voor nadere beoordeling.

Onderwijsplatforms

Retourneer een beoordelingssignaal naast opdrachtcontext, revisiegeschiedenis, citaten en het eigen beleid van de instelling.

Interne moderatie

Controleer aangeleverde tekst in een afgeschermd proces zonder je API-sleutel naar de browser te sturen.

Batchtriage

Verwerk documenten in de wachtrij op de server en breng de cases naar boven die een handmatige tweede blik verdienen.

Veelgestelde vragen over de API

Praktische antwoorden voor je live gaat

Begin met een serververzoek, leg de structuur van het antwoord vast en voeg het resultaat daarna toe aan je bestaande beoordelingsproces.

Welk endpoint gebruikt de AI-detector-API?+

Stuur een POST-verzoek naar https://api.detecting-ai.com/api/detect/. De hoofdtekst van het verzoek is JSON, authenticatie gebruikt X-API-Key en nieuwe integraties moeten voor elke logische bewerking een stabiele Idempotency-Key behouden.

Welke detectorversie moet een nieuwe integratie gebruiken?+

Gebruik v3 voor nieuwe integraties. De versie wordt geleverd in de verzoektekst JSON, zodat het gedrag expliciet en eenvoudig te testen is.

Kan ik de API rechtstreeks vanuit JavaScript in de browser aanroepen?+

Stel nooit een persoonlijke API-sleutel bloot in browsercode. Verstuur verzoeken vanaf je server, een edgefunctie of een andere vertrouwde omgeving en retourneer alleen het resultaat dat je interface nodig heeft.

Bewijst een AI-score wie de tekst heeft geschreven?+

Nee. AI-detectie is een probabilistisch signaal. Gebruik het om de beoordeling op specifieke passages te richten en betrek daarna concepten, bronnen, schrijfgeschiedenis en de bredere context.

Waar kan ik het gebruik van API en de resterende woorden controleren?+

Het API-dashboard toont de resterende woordlimiet van je abonnement. Elk geslaagd detectorverzoek vermeldt het aantal verwerkte invoerwoorden.

Bouw het eerste verzoek

Dien één testverzoek in voordat je de workflow ontwerpt

Gebruik detector v3, bewaar de sleutel op je server en inspecteer het volledige antwoord JSON met tekst die lijkt op je echte invoer.