Interface

DustOff dans vos propres outils

Qui suit beaucoup de sites clients ne veut pas les contrôler un par un. L'interface prend une adresse, la contrôle et répond avec ce qui attire l'œil — sous forme de données à mettre dans vos outils.

Demander l'accès

Ce qu'elle fait

Envoyer un site et le faire contrôler tout de suite.
Recevoir le résultat en données : page, endroit, raison, proposition.
Reprendre un contrôle plus tard.
Demander son état : formule, budget, ce qui reste.

Un tour, du début à la fin

1
Demander
Envoyez l'adresse et la profondeur voulue. DustOff lit le site public — rien n'est installé.
2
Recevoir
Le contrôle part tout de suite et répond tout de suite : combien de pages ont été lues et quels endroits attirent l'œil.
3
Placer
Mettez le résultat là où le travail se fait : le rapport client, la file de tickets, la passation.

Demande

La clé voyage dans l'en-tête de la demande. Elle n'appartient pas à une 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" }'

Réponse

Le même résultat peut être repris plus tard avec l'identifiant du contrôle.

{
  "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
    }
  ]
}

Limites

Une clé contrôle à la formule de son adresse.
Un budget de pages par mois, fixé à la remise.
Trop de demandes en peu de temps sont ralenties.
La profondeur d'un seul contrôle reste bornée par la formule.

Quand ça ne marche pas

401: Pas de clé, une mauvaise ou une bloquée.
400: Cette adresse n'a pas pu être lue comme site.
409: Ce site est en cours de contrôle.
429: Trop de demandes, ou le budget du mois est épuisé.
503: Le contrôle de fond est coupé pour l'instant.

Clés d'accès sur demande

DustOff remet les clés à la main. Une ligne avec le nom, l'adresse et l'ampleur souhaitée suffit — la clé et l'adresse à laquelle elle appartient suivent.

Demander l'accès

Ce qui est conservé

Chaque appel laisse la marque de la clé, le chemin, le résultat et l'heure — l'adresse IP seulement comme empreinte non reconstructible. Après 30 jours, le journal disparaît.

Plus dans la politique de confidentialité