Stellen-API
Die Jobs-API verwaltet manuelle Crawls. Die Jobs-API befindet sich am Endpunkt
https://www.consentmanager.net/api/job.php
Erstellen Sie einen neuen Job
Um einen neuen Job zu erstellen, senden Sie bitte einen HTTP-POST mit den folgenden Parametern an die Jobs-API:
Parameter |
Beschreibung |
Beispiel |
Schlüssel |
Authentifizierungsschlüssel |
jf892rt |
URL |
URL, die gecrawlt werden soll |
https://www.cnn.com/ |
Jobergebnis erstellen
Die API gibt das folgende Objekt zurück:
{
"status":"created", //status, always “created”
"message": "Job created", //status message
"jobid": "..." //job ID, varchar(64)
}
Abrufen eines Auftragsergebnisses
Um das Ergebnis für einen Job abzurufen, senden Sie bitte ein HTTP-GET mit den folgenden Parametern an die Jobs-API:
Parameter |
Beschreibung |
Beispiel |
Schlüssel |
Authentifizierungsschlüssel |
jf892rt |
Job-ID |
ID des Jobs (Eigenschaft "jobid" aus "Jobergebnis erstellen") |
22-a6c51bfb |
Jobergebnis abrufen
Die API gibt das folgende Objekt zurück:
{
"status":"done", //status, either pending or done
"message": "Job done", //status message
"risk": 75, //calculated risk, only present if status=done
"reporturl": "..." //Report-URL, only present if status=done
}
Fehlercodes
Die folgenden Fehlercodes können auftreten:
HTTP-Code |
Desciption |
400 |
Falsche Parameter übermittelt |
403 |
Falscher Schlüssel |
404 |
Daten nicht gefunden |
429 |
Maximale Anzahl von Jobs / Anrufen pro Tag erreicht |