Quickstart
La API es anónima: no hace falta cuenta ni API key para empezar.
Tu primera petición
terminal
curl "https://datamockseed.firstflip.es/api/v1/es/document?sub=dni&count=3"Esto devuelve 3 DNI ficticios, con letra de control válida:
{
"status": "success",
"meta": {
"generator": "document",
"locale": "es",
"seed": "…",
"count": 3,
"options": { "sub": "dni", "ok": "true", "fmt": "plain" }
},
"data": [
{ "documento": "12345678Z", "tipo": "DNI" },
{ "documento": "87654321X", "tipo": "DNI" },
{ "documento": "11223344B", "tipo": "DNI" }
]
}
Cambia de generador
Sustituye document por cualquiera de los generadores listados en /docs/generadores/document: iban, card, phone, identity, passport, uuid, username, password.
Cantidad y semilla
count: cuántos registros devuelve (máximo 1000 en este endpoint).seed: misma seed + mismos parámetros ⇒ mismos datos, siempre. Si la omites, la API elige una al azar y te la devuelve enmeta.seed.
terminal
curl "https://datamockseed.firstflip.es/api/v1/es/document?sub=dni&count=3&seed=mi-seed-de-test"Registros compuestos
Para generar filas con varias columnas coherentes entre sí (nombre + DNI + email + IBAN…), usa POST /v1/es/bulk: ver /docs/api/bulk.
Siguiente paso
- Autenticación: API anónima, sin credenciales.
- Rate limits: cuántas peticiones por minuto tienes.