GET

/api/v1/{locale}/{generator}

Genera registros de un tipo.

Parámetros

Nombre	En	Requerido	Tipo / valores	Descripción
locale	path	Sí	string, enum(es)	—
generator	path	Sí	string, enum(document · phone · identity · iban · card · passport · uuid · username · password)	—
count	query	No	integer, 1–1000, default: 1	—
seed	query	No	string	Equivalente a la cabecera X-Seed.
X-Seed	header	No	string	—

Ejemplo de uso

terminal

curl "https://datamockseed.firstflip.es/api/v1/es/document?sub=dni&ok=true&fmt=plain&count=2&seed=docs-ejemplo"

Respuesta de ejemplo

Generada al construir esta página, con la misma seed determinista (docs-ejemplo).

{
  "status": "success",
  "meta": {
    "generator": "document",
    "locale": "es",
    "seed": "docs-ejemplo",
    "count": 2,
    "options": {
      "sub": "dni",
      "ok": "true",
      "fmt": "plain"
    }
  },
  "data": [
    {
      "documento": "29127292T",
      "tipo": "DNI"
    },
    {
      "documento": "61521712R",
      "tipo": "DNI"
    }
  ]
}

Probar en vivo

Errores de este endpoint

400UNSUPPORTED_LOCALE
El `locale` de la URL no está soportado (por ahora solo "es").
404UNKNOWN_GENERATOR
El `generator` de la URL no existe (`GET /generators` lista los válidos).
400INVALID_PARAMS
Falta un parámetro obligatorio o tiene un valor no válido (p. ej. "count").
413COUNT_LIMIT_EXCEEDED
"count" supera el máximo permitido por ese endpoint.
429RATE_LIMIT_EXCEEDED
Se superó el límite de peticiones por minuto para tu IP.

Detalle completo en /docs/errores.