← Volver al índice de esquemas
PlaygroundProxyRequest
Envoltorio JSON:API de la petición del proxy del Playground. El servidor reenvía la operación descrita en `data.attributes` al endpoint `/v1` destino usando la API key del propio usuario (descifrada del lado servidor), de modo que la clave nunca llega al navegador.
Propiedades
| Campo | Tipo | Descripción |
|---|---|---|
data * | object | |
type * | string | Tipo del recurso JSON:API. |
attributes * | object | |
mode * | string | `live` reenvía la petición real al endpoint destino y devuelve su respuesta tal cual (passthrough). `playground` ejecuta el motor de simulación con escenarios y devuelve la misma respuesta que daría el endpoint real para el escenario elegido, sin efectos colaterales (sin cuota, webhooks ni notificaciones). |
method * | string | Método HTTP de la operación destino. |
path * | string | Ruta absoluta del endpoint destino, con el prefijo `/v1` (por ejemplo `/v1/beneficiaries`). Debe corresponder a una operación documentada; rutas no listadas devuelven `403 path_not_allowed`. |
query | object | Parámetros de query a agregar a la URL destino. Opcional. |
headers | object | Cabeceras del cliente a reenviar. Solo se propaga una lista acotada (p. ej. `Idempotency-Key`, `Accept-Language`); el resto se descarta. La credencial del destino la pone el servidor — nunca se reenvía `Authorization` ni `Cookie` del cliente. |
body | object | null | Cuerpo de la petición destino para métodos distintos de `GET`. Opcional / `null` cuando no aplica. |
scenario | object | Escenario de simulación para `mode: playground` (ignorado en `mode: live`). `id` selecciona el escenario (p. ej. `valid`, `not_found`) de los que lista `GET /v1/playground/templates`. |
id | string | Identificador del escenario pre-cargado. |
inputs | object | Entradas que parametrizan el escenario. |
Usado en operaciones
POST /v1/playground/proxy