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 en meta.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