Distintos objetos te permiten ampliar la respuesta enviada por la API utilizando el parámetro de solicitud de expansión (expand
).
En muchos casos, un objeto contiene el ID de otro objeto relacionado a este. Por ejemplo, un checkout
puede tener un ID de customer
asociado con el atributo customer_id
. En este caso, puedes obtener en la misma respuesta de checkout
el detalle del customer
asociado, sin necesidad de consultar la API de customer
de forma independiente, utilizando el parámetro expand
. En este ejemplo, debieras agregar el valor customer
al parámetro expand
de la forma expand[]=customer
.
Los atributos que se pueden expandir en objetos se indican en la documentación con la etiqueta _expandible_
.
El parámetro de expansión (expand
) es un array
que acepta un listado de strings
como items. El valor de cada item corresponde al nombre del atributo mencionado en la documentación, por ejemplo expand[]=customer
.