Dribba · Sandbox

Entorno de pruebas

Base https://dribba.com/sandbox. Mismas rutas y mismos esquemas que producción, con datos congelados. Sin claves, sin registro y sin nada que se pueda romper.

Para qué sirve, y para qué no

Un sandbox suele existir para aislar escrituras. Aquí no hay ninguna: toda la API pública es de lectura. Lo que este entorno aísla es otra cosa —tus tests de nuestros cambios.

Un test que afirme «hay 9 servicios» o «el primer caso es CityXerpa» contra producción se rompe el día que publiquemos el décimo servicio o reordenemos la portada de casos, y parecerá un fallo de tu código. Contra el sandbox, la respuesta de hoy es la de dentro de un año.

Los datos son ficticios a propósito — «Acme Corp», acme-superapp— para que nadie los confunda con clientes reales. Los números del estimador tampoco sirven para cotizar: para eso está el endpoint de producción.

Empezar

# Qué fixtures hay
curl https://dribba.com/sandbox/api/v1

# Un fixture de colección
curl https://dribba.com/sandbox/api/v1/services

# Y una ruta de detalle
curl https://dribba.com/sandbox/api/v1/cases/acme-superapp

# El estimador, con respuesta constante
curl -X POST https://dribba.com/sandbox/api/v1/estimate \
  -H 'Content-Type: application/json' \
  -d '{"platforms":["ios","android"]}'

Toda respuesta del sandbox lleva la cabecera X-Sandbox: true y el campo sandbox: true en el cuerpo. Es imposible confundir un entorno con el otro mirando la respuesta, que es justo lo que se quiere de un sandbox.

Fixtures disponibles

  • GET /sandbox/api/v1/company
  • GET /sandbox/api/v1/services
  • GET /sandbox/api/v1/cases
  • GET /sandbox/api/v1/articles
  • GET /sandbox/api/v1/jobs
  • GET /sandbox/api/v1/pricing
  • GET /sandbox/api/v1/comparisons
  • POST /sandbox/api/v1/estimate

Las colecciones aceptan la misma paginación por cursor que producción (?limit=, ?cursor=) y los mismos errores RFC 9457. Los 18 endpoints de producción están en la referencia.

En el contrato

El sandbox es el segundo servers del OpenAPI, así que un cliente generado con openapi-generator cambia de entorno cambiando la URL base — sin tocar rutas ni modelos.

servers:
  - url: https://dribba.com          # producción
  - url: https://dribba.com/sandbox  # fixtures congelados

Lo que no hay: cuentas de sandbox, claves de prueba ni datos que puedas modificar. No hacen falta — no hay autenticación en ningún entorno.