Interfaz
DustOff en tus propias herramientas
Quien cuida muchos sitios de clientes no quiere revisarlos uno por uno. La interfaz recibe una dirección, la revisa y responde con lo que llama la atención — como datos para tus propias herramientas.
Qué puede hacer
- Enviar un sitio y que se revise al momento.
- Recibir el resultado como datos: página, lugar, motivo, propuesta.
- Volver a pedir una revisión más tarde.
- Consultar tu estado: plan, presupuesto, lo que queda.
Así va una vuelta
1
Pedir
Manda la dirección y la profundidad que quieres. DustOff lee el sitio público — no se instala nada.
2
Recibir
La revisión arranca enseguida y responde enseguida: cuántas páginas se leyeron y qué lugares llaman la atención.
3
Colocar
Pon el resultado donde está el trabajo: el informe del cliente, la cola de tickets, el traspaso.
Petición
La clave viaja en la cabecera de la petición. No pertenece a una dirección.
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" }'Respuesta
El mismo resultado puede volver a pedirse más tarde con el identificador de la revisión.
{
"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
}
]
}Límites
- Una clave revisa según el plan de su dirección.
- Un presupuesto de páginas al mes, fijado al entregarla.
- Demasiadas peticiones en poco tiempo se frenan.
- La profundidad de una sola revisión sigue limitada por el plan.
Cuando algo falla
- 401
- Sin clave, con una equivocada o una bloqueada.
- 400
- Esa dirección no se pudo leer como sitio.
- 409
- Ese sitio se está revisando ahora mismo.
- 429
- Demasiadas peticiones o el presupuesto del mes está agotado.
- 503
- La revisión de contenidos está apagada ahora mismo.
Claves de acceso a petición
DustOff entrega las claves a mano. Basta una línea con el nombre, la dirección y el tamaño que necesitas — la clave y la dirección a la que pertenece vienen después.
Qué se guarda
De cada llamada quedan la etiqueta de la clave, el camino, el resultado y la hora — la dirección IP solo como marca no reconstruible. A los 30 días el registro desaparece.