Stellen-API
Die Jobs-API verwaltet manuelle Crawls. Die Jobs-API befindet sich am Endpunkt
https://app.consentmanager.net/api/job.phpErstellen 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 |
