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.
REST API / AI-detectie
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 --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"
}'POST-verzoeken naar /api/detect/
Authenticatie met X-API-Key
Idempotency-Key van de client voor veilige nieuwe pogingen
Detector v3 voor nieuwe integraties
JSON-verzoek en -antwoord
Gebouwd voor echte beoordelingsprocessen
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.
Voeg een tekstreeks en detectorversie toe aan een JSON-verzoek. Voor de basisintegratie hoef je geen aparte SDK bij te houden.
Lees de detectordetails, versie en het aantal verwerkte woorden uit het antwoord in plaats van een webpagina uit te lezen.
Gebruik het signaal om passages en zaken te prioriteren. Maak van één modelscore geen automatische beschuldiging of afwijzing.
Verzoekcontract
Verzend UTF-8-tekst als JSON en kies bewust de detectorversie. Nieuwe integraties moeten v3 gebruiken.
| Veld | Type | Vereist | Wat het doet |
|---|---|---|---|
| text | string | Ja | De tekst die je door de detector wilt laten analyseren. |
| version | string | Ja | Detectorversie. Gebruik v3 voor een nieuwe integratie. |
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.
{
"success": true,
"data": {
"details": {
"result": "Detector analysis is returned here"
},
"version": "v3",
"words_processed": 8
}
}Integratiestappen
Bouw het verzoek eerst op je server. Voeg de productinterface pas toe nadat het succesvolle scenario en de foutgevallen duidelijk zijn.
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.
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.
Zet het gestructureerde antwoord om in een duidelijke beoordelingsweergave, met ruimte om de tekst en context te controleren.
Geschikte toepassingen
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.
Modellen kunnen fouten maken, vooral bij korte, sterk bewerkte, vertaalde of formulematig geschreven tekst. Laat beslissingen met gevolgen nooit volledig automatisch nemen.
Voeg een auteurschapssignaal toe aan ingediende concepten en stuur ongebruikelijke gevallen door naar een redacteur voor nadere beoordeling.
Retourneer een beoordelingssignaal naast opdrachtcontext, revisiegeschiedenis, citaten en het eigen beleid van de instelling.
Controleer aangeleverde tekst in een afgeschermd proces zonder je API-sleutel naar de browser te sturen.
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
Begin met een serververzoek, leg de structuur van het antwoord vast en voeg het resultaat daarna toe aan je bestaande beoordelingsproces.
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.
Gebruik v3 voor nieuwe integraties. De versie wordt geleverd in de verzoektekst JSON, zodat het gedrag expliciet en eenvoudig te testen is.
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.
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.
Het API-dashboard toont de resterende woordlimiet van je abonnement. Elk geslaagd detectorverzoek vermeldt het aantal verwerkte invoerwoorden.
Bouw het eerste verzoek
Gebruik detector v3, bewaar de sleutel op je server en inspecteer het volledige antwoord JSON met tekst die lijkt op je echte invoer.