Schnittstelle
DustOff in die eigenen Werkzeuge holen
Wer viele Kundenseiten betreut, will nicht für jede einzeln nachsehen. Die Schnittstelle nimmt eine Adresse an, prüft sie und antwortet mit dem, was auffällt — als Daten, die ins eigene Werkzeug gehören.
Was sie kann
- Eine Website hinschicken und sofort prüfen lassen.
- Das Ergebnis als Daten zurückbekommen: Seite, Stelle, Grund, Vorschlag.
- Eine Prüfung später noch einmal abrufen.
- Den eigenen Stand abfragen: Tarif, Budget, was noch übrig ist.
So läuft ein Durchgang
1
Anfragen
Adresse und gewünschte Prüftiefe hinschicken. DustOff sieht die öffentliche Website durch — installiert wird nichts.
2
Erhalten
Die Prüfung läuft sofort und antwortet direkt: wie viele Seiten gelesen wurden und welche Stellen auffallen.
3
Einbauen
Ergebnis dort ablegen, wo die Arbeit passiert: im Kundenbericht, im Ticketsystem, in der Übergabe.
Anfrage
Im Kopf der Anfrage steht der Schlüssel. Er gehört nicht in eine Adresse.
curl -X POST https://getdustoff.com/api/public/v1/pruefungen \
-H "Authorization: Bearer dustoff_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d" \
-H "Content-Type: application/json" \
-d '{ "url": "https://beispiel.de", "seiten": 300, "sprache": "de" }'Antwort
Dasselbe Ergebnis lässt sich später über die Kennung der Prüfung noch einmal holen.
{
"pruefung": "b41d9f2c-6f1e-4a7c-9d3b-2c8a5e7f1042",
"status": "fertig",
"website": "https://beispiel.de",
"seiten_gelesen": 148,
"prueftiefe": 300,
"grenze_erreicht": false,
"stellen": [
{
"seite": "https://beispiel.de/aktuell",
"titel": "Neuigkeiten",
"art": "stale-year",
"fundstelle": "© 2023",
"begruendung": "Die Jahreszahl im Fuß stammt aus dem Vorjahr.",
"vorschlag": "Jahreszahl auf das laufende Jahr setzen.",
"sicherheit": 0.92,
"wiederholungen": 12
}
]
}Grenzen
- Ein Zugang prüft im Tarif seiner Adresse.
- Ein Seitenbudget je Monat, bei der Vergabe festgelegt.
- Zu viele Anfragen in kurzer Zeit werden gedrosselt.
- Die Prüftiefe einer einzelnen Prüfung bleibt durch den Tarif gedeckelt.
Wenn etwas nicht klappt
- 401
- Kein Schlüssel, ein falscher oder ein gesperrter.
- 400
- Die Adresse konnte nicht als Website gelesen werden.
- 409
- Diese Website wird gerade geprüft.
- 429
- Zu viele Anfragen oder das Monatsbudget ist aufgebraucht.
- 503
- Die inhaltliche Prüfung ist gerade abgeschaltet.
Zugangsschlüssel auf Anfrage
Schlüssel vergibt DustOff von Hand. Ein Satz mit Namen, Adresse und dem gewünschten Umfang genügt — dann kommt der Schlüssel und die Adresse, an die er gehört.
Was dabei gespeichert wird
Von jedem Aufruf bleiben Schlüsselkennung, Weg, Ergebnis und Zeit stehen — die IP-Adresse nur als nicht rückrechenbarer Vermerk. Nach 30 Tagen ist das Protokoll weg.