/api/v1/{locale}/bulk

Genera registros compuestos a partir de un esquema.

Parámetros

Cuerpo de la petición

{
  "seed": "docs-ejemplo",
  "count": 3,
  "format": "json",
  "fields": [
    {
      "name": "documento",
      "type": "documento"
    },
    {
      "name": "email",
      "type": "email"
    },
    {
      "name": "iban",
      "type": "iban"
    }
  ]
}

Ejemplo de uso

curl -X POST "https://datamockseed.firstflip.es/api/v1/es/bulk" \
  -H "Content-Type: application/json" \
  -d '{"seed":"docs-ejemplo","count":3,"format":"json","fields":[{"name":"documento","type":"documento"},{"name":"email","type":"email"},{"name":"iban","type":"iban"}]}'

Respuesta de ejemplo

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

{
  "status": "success",
  "meta": {
    "locale": "es",
    "seed": "docs-ejemplo",
    "count": 3,
    "fields": [
      {
        "name": "documento",
        "type": "documento"
      },
      {
        "name": "email",
        "type": "email"
      },
      {
        "name": "iban",
        "type": "iban"
      }
    ],
    "checksum_valid": true
  },
  "data": [
    {
      "documento": "41149646R",
      "email": "l.garridoiglesias@example.net",
      "iban": "ES4514653507010270624785"
    },
    {
      "documento": "15108176M",
      "email": "maria.blanco@example.com",
      "iban": "ES5201828508817332283035"
    },
    {
      "documento": "53385481C",
      "email": "d.castropena@example.net",
      "iban": "ES2500499547640779607410"
    }
  ]
}

Errores de este endpoint

• 400UNSUPPORTED_LOCALE

  El `locale` de la URL no está soportado (por ahora solo "es").

• 400INVALID_BODY

  El cuerpo de la petición no es JSON válido, o no tiene la forma esperada.

• 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.