REST API
Dorrat API
Api 100% de uso gratuito para tus proyectos, por ItsDevDiego.
Base URL
/v1/* /v2/*
Formato de respuesta
Todas las respuestas siguen el mismo envoltorio JSON.
ok
boolean
true si fue exitoso, false si falló.
data
object
Presente cuando
ok: true. Contiene el resultado.
error
string
Presente cuando
ok: false. Describe el error.
ts
number
Timestamp Unix en milisegundos.
JSON · Éxito
{
"ok": true,
"data": { /* resultado */ },
"ts": 1721500000000
}
JSON · Error
{
"ok": false,
"error": "Parámetro url requerido",
"ts": 1721500000000
}Rate Limiting
El servidor limita peticiones por dirección IP.
Límite
100 / min
Máximo 100 peticiones por minuto por IP.
Bloqueo
60 s
Al superar el límite, la IP queda bloqueada 60 segundos.
Respuesta
HTTP 429
Las IPs bloqueadas reciben 429 con
ok: false.
Códigos de estado
La API usa códigos HTTP estándar junto al campo ok.
- 200Petición exitosa —
ok: true. - 400Parámetro inválido o faltante —
ok: false. - 429Rate limit superado — IP bloqueada 60 s.
- 502Error del proveedor externo (scraper falló).
- 504Timeout de la petición superado.