Skip to main content
API para mentores

Mi catálogo (listar y buscar)

Lista tus productos por tipo y estado, o encuentra uno por tu external_ref.

Written By Jacobo

Last updated 23 days ago

Estas rutas devuelven solo tus productos (los del dueño de la API Key), incluidos borradores. Te sirven para saber qué tienes creado y en qué estado está, o para recuperar un producto sin haber guardado nuestro id.

Listar

GET /{tipo}?limit=20&cursor=…

{tipo} es programs, external, workshops o checkouts.

ParámetroDescripción
limitResultados por página (por defecto 20, máximo 100)
cursorEl next_cursor de la página anterior

Los resultados vienen del más reciente al más antiguo e incluyen todos los estados (el state de cada item te dice si está en borrador, publicado o despublicado):

{
  "items": [
    { "id": "6ab8...f001", "type": "program", "state": "published", "checkout_url": "https://…", "...": "..." }
  ],
  "next_cursor": "eyJ..."
}

Cuando next_cursor es null, no hay más páginas.

Buscar por external_ref

GET /{tipo}?external_ref=mi-plataforma-diplomado-42

Devuelve el producto que creaste con ese external_ref, o 404 si no existe.

¿Buscas valores para armar un request?

Las categorías, monedas, tipos de programa, proveedores de video y frecuencias de suscripción válidas están en Datos de referencia (GET /reference/{kind}).