Descripción general de los endpoints de la API de Plecto

Lista de endpoints de la API de Plecto

Plecto le permite acceder a los siguientes endpoints usando la URL base de V2 o V3:

URL base: https://app.plecto.com/api/v2/

Endpoints de V2, agrupados por tema:

• /dashboards/

• /datasources/

• /registrations/

• /members/

• /teams/

  • /my-teams/

• /slideshows/

  • /screens/

  • /screen-devices/

  • /devices/

• /favorites/

• /formulas/

URL base: https://app.plecto.com/api/v3/

Endpoints de V3:

• /achievement-types/

  • /achievement-type-icons/

• /posts/

Dashboards

• Endpoint: https://app.plecto.com/api/v2/dashboards/

• Métodos: GET, POST

• Descripción: Obtener o crear dashboards en Plecto. GET devuelve detalles sobre los dashboards existentes, mientras que POST crea un nuevo dashboard.

• Ejemplo de solicitud POST arriba

Favoritos

• Endpoint: https://app.plecto.com/api/v2/favorites/

• Métodos: GET, POST

• Descripción: Obtener dashboards marcados como favoritos o añadir nuevos favoritos. Los dashboards favoritos aparecen como accesos directos en la página de inicio de la interfaz de Plecto.

• Ejemplo de solicitud POST arriba

Publicaciones del feed de noticias

• Endpoint: https://app.plecto.com/api/v3/posts/

• Métodos: GET

• Descripción: Leer publicaciones y enviar actualizaciones a su feed de noticias de Plecto.

• Ejemplo de solicitud POST arriba

Dispositivos

• Endpoint: https://app.plecto.com/api/v2/devices/

• Métodos: GET, POST

• Descripción: Obtener o crear dispositivos vinculados al usuario de la API, como un televisor activado o una aplicación móvil en la que el usuario haya iniciado sesión.

• Ejemplo de solicitud POST arriba

El nombre de usuario y la contraseña son necesarios para crear un token, que recibirá en la respuesta de la solicitud.

Teams

• Endpoint: https://app.plecto.com/api/v2/teams/

• Métodos: GET, POST

• Descripción: Crear o listar equipos dentro de Plecto. Los equipos se usan para agrupar miembros y asociarlos con dashboards, fuentes de datos y otras funciones.

• Ejemplo de solicitud POST arriba

Registrations

• Endpoint: https://app.plecto.com/api/v2/registrations/

• Métodos: GET, POST, PUT, DELETE

• Descripción: Obtener, actualizar o eliminar registros asociados a una fuente de datos.

• Información de uso:

  • Puede usar GET, PUT y DELETE en un registro específico en la URL /api/v2/registrations/<data_source>/<uuid>/

  • Puede filtrar registros con los siguientes parámetros de cadena de consulta:

    • start_date (https://app.plecto.com/api/v2/registrations/?start\_date=2024-06-01T22:22:00)

    • end_date (https://app.plecto.com/api/v2/registrations/?end\_date=2024-06-01T22:22:00)

    • reference/external_id (https://app.plecto.com/api/v2/registrations/?reference=123)

    • data_source (https://app.plecto.com/api/v2/registrations/?data\_source=412c64d13fbf4c89bacd4224fb16a6db)

  • Puede controlar la paginación con el parámetro "page".

• Ejemplo de solicitud POST a /api/v2/registrations/ arriba

My teams

• Endpoint: https://app.plecto.com/api/v2/my-teams/

• Métodos: GET

• Descripción: Lista los equipos de los que el usuario autenticado es miembro o gestor. Los administradores globales seguirán viendo todos los equipos; todos los demás usuarios solo verán sus equipos asociados.

Screens

• Endpoint: https://app.plecto.com/api/v2/screens/

• Métodos: GET

• Descripción: Obtener una lista de presentaciones de diapositivas (slideshows). Los detalles incluyen el UUID de la presentación, el nombre, la rotación y el UUID de la organización.

Members

• Endpoint: https://app.plecto.com/api/v2/members/

• Métodos: GET, POST

• Descripción: Gestionar los datos de los miembros de la organización. Los miembros aparecerán listados en la página Empleados de Plecto, y si envían datos, se mostrarán en las fuentes de datos correspondientes.

• Información de uso: Use GET para filtrar según parámetros como api_provider o api_id, y POST para añadir nuevos miembros:

  • GET /api/v2/members/?api_provider=<su api_provider>&api_id=<su id>

• Ejemplo de solicitud POST arriba

Screen devices

• Endpoint: https://app.plecto.com/api/v2/screen-devices/

• Métodos: GET

• Descripción: Este endpoint devuelve una lista de pantallas (televisores o pantallas de ordenador) a las que se han enviado sus presentaciones de diapositivas.

Themes

• Endpoint: https://app.plecto.com/api/v2/themes/

• Métodos: GET, POST

• Descripción: Obtener o crear nuevos temas que pueda usar en los dashboards y concursos de Plecto.

• Ejemplo de solicitud POST arriba

Slideshows

• Endpoint: https://app.plecto.com/api/v2/slideshows/

• Métodos: GET, POST

• Descripción: Use esto para gestionar sus presentaciones de diapositivas de Plecto. Puede crear presentaciones con varios tipos de diapositivas: dashboard, concurso, YouTube y URL.

• Ejemplo de solicitud POST arriba

Achievements

• Endpoint: https://app.plecto.com/api/v3/achievement-types/

• Métodos: GET, POST

• Descripción: Obtener o crear nuevos logros (achievements) en Plecto. Elija entre logros de premio, récord o membresía. Obtenga más información sobre cómo funcionan los logros aquí.

• Ejemplo de solicitud POST arriba

Data sources

• Endpoint: https://app.plecto.com/api/v2/datasources/

• Métodos: GET, POST

• Descripción: Acceder a o crear fuentes de datos, que sirven como base para gestionar datos dentro de Plecto.

• Ejemplo de solicitud POST arriba

teams vs. my-teams: ¿cuál es la diferencia?

La diferencia entre los endpoints /teams/ y /my-teams/ radica en el alcance y los detalles de los datos que proporcionan:

Alcance de los datos:

• /teams/ obtiene todos los equipos dentro de la organización. Proporciona información sobre cada equipo, incluyendo su id, uuid, miembros, gestores, organización y fuentes de datos asociadas.

• /my-teams/ devuelve solo los equipos que están directamente asociados con el usuario autenticado. Estos suelen ser los equipos de los que el usuario es miembro o gestor.

Detalles de la respuesta:

• /teams/ proporciona un conjunto de datos más completo para cada equipo, como id, organization, data_sources, home_dashboard y home_screens. Utiliza ID numéricos para miembros y gestores.

• /my-teams/ ofrece una vista simplificada de cada equipo, omitiendo algunos campos como organization, home_dashboard y data_sources. La respuesta incluye un campo picture y utiliza UUID para miembros y gestores en lugar de ID numéricos.

Diferencias en el caso de uso:

• Use /teams/ cuando necesite una lista completa de todos los equipos de la organización o requiera información detallada sobre los equipos.

• Use /my-teams/ para obtener rápidamente los equipos con los que el usuario autenticado está asociado, lo cual es útil para dashboards personalizados o funcionalidades específicas del usuario.

Formulas

• Endpoint: https://app.plecto.com/api/v2/formulas/

• Métodos: GET, POST

• Descripción: Obtener o crear fórmulas. Todas las fórmulas son universales y se pueden usar en todas las funciones de Plecto.

• Ejemplo de solicitud POST arriba

Achievement type icons

• Endpoint: https://app.plecto.com/api/v3/achievement-type-icons/

• Métodos: GET

• Descripción: Obtener los iconos de sus insignias de logros. Recibirá los enlaces de las imágenes en el cuerpo de la respuesta.