API para Desarrolladores

Integra identidades chilenas sintéticas en tus aplicaciones gratuitamente

Endpoint Principal

GET https://chilegen.cl/api/random

Parámetros

ParámetroTipoRequeridoDescripción
modestringOpcionalUsa advanced para obtener datos bancarios y de salud. Por defecto: modo básico.
qtynumberOpcionalCantidad de identidades a generar (1 a 10). Por defecto: 1.

Ejemplo de Uso

curl https://chilegen.cl/api/random?mode=advanced&qty=2

Este ejemplo genera 2 identidades con datos avanzados (bancarios y de salud).

Ejemplo de Respuesta

{
  "success": true,
  "data": [
    {
      "name": "María Fernanda González Silva",
      "rut": "18.234.567-8",
      "age": 32,
      "phone": "+56 9 8765 4321",
      "email": "maria.gonzalez@example.com",
      "address": "Calle Los Aromos 1234, Las Condes, Región Metropolitana",
      "healthInsurance": "FONASA",
      "afp": "Capital",
      "maritalStatus": "Soltero",
      "bloodType": "O+",
      "bankAccount": {
        "bank": "Banco de Chile",
        "accountType": "Cuenta Corriente",
        "accountNumber": "1234567890"
      },
      "creditCard": {
        "brand": "Visa",
        "number": "4532 1234 5678 9010",
        "cvv": "123",
        "expiryMonth": "12",
        "expiryYear": "2025"
      }
    }
  ]
}

Estructura de la Respuesta:

  • success: Indica si la solicitud fue exitosa (boolean)
  • data: Array de identidades generadas
  • error: Mensaje de error (solo presente si success es false)

Límites de Uso

Rate Limit: 10 peticiones cada 10 segundos por IP.

Si excedes este límite, recibirás un error 429 (Too Many Requests). Por favor, implementa un sistema de reintentos con backoff exponencial.

Información Adicional

La API es completamente gratuita y no requiere autenticación.
Los datos generados son sintéticos y solo para propósitos de testing y desarrollo.
La API soporta CORS y puede ser utilizada desde aplicaciones web del lado del cliente.
En modo advanced, se incluyen datos bancarios, de salud y personales adicionales.