← 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