Saltar al contenido principal
GET
Python (SDK)

Autorizaciones

Authorization
string
header
requerido

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Encabezados

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Parámetros de consulta

after
string

Un ID de solicitud para usar como cursor para la paginación. Devuelve las entradas de comentarios que vienen después de este ID en la lista. Si el ID ya no se resuelve a una solicitud visible para el llamador (por ejemplo, la respuesta subyacente fue eliminada), la solicitud falla con 400; reinicie la paginación desde la primera página.

limit
integer
predeterminado:20

El número máximo de entradas de comentarios a devolver por página. Debe estar entre 1 y 100. El valor predeterminado es 20 elementos.

Rango requerido: 1 <= x <= 100
order
enum<string>
predeterminado:desc

El orden para devolver las entradas de comentarios según la fecha de creación de la solicitud subyacente. 'asc' devuelve primero las más antiguas, 'desc' devuelve primero las más recientes. El valor predeterminado es 'desc' (primero las más recientes).

Opciones disponibles:
asc,
desc
rating
enum<string>

Devuelve solo las entradas de comentarios con esta calificación. Omite para devolver entradas con cualquier calificación.

Opciones disponibles:
thumbs_up,
thumbs_down

Respuesta

200 - application/json

Está bien

Objeto de lista paginada que contiene entradas de comentarios con metadatos de paginación basados en cursores.

object
any
requerido

El tipo de objeto, siempre 'lista' para respuestas de listas paginadas.

data
object[]
requerido

Matriz de entradas de comentarios ordenadas por fecha de creación de la solicitud subyacente.

has_more
boolean
requerido

Indica si hay más entradas de comentarios disponibles más allá de la página actual. Verdadero si existen páginas adicionales.

first_id
string

El ID de la primera entrada de comentarios en la página actual. Se utiliza como punto de referencia para la paginación.

last_id
string

El ID de la última entrada de comentarios en la página actual. Se utiliza como cursor para recuperar la siguiente página.