Neste artigo, você aprenderá como utilizar o endpoint que lista todos os marketplaces disponíveis para integração com o Hub Ideris.
Esse endpoint retorna a mesma lista de canais disponíveis tanto na interface gráfica do sistema quanto na API.
Endpoint Disponível
Buscar Lista de Marketplaces
- Método: GET
- URL: https://apiv3.ideris.com.br/marketplace
- Objetivo: Retornar uma lista com todos os marketplaces que o Ideris íntegra.
Orientações para Uso
Cabeçalhos Necessários:
-
- Adicione o seguinte cabeçalho:
- Content-Type: application/json
- O token de autenticação retornado pela ação Login.
- Adicione o seguinte cabeçalho:
Parâmetros de Filtro:
O endpoint aceita os seguintes filtros opcionais, que podem ser incluídos na URL:
-
-
offset: Define o ponto inicial da busca, útil para paginação.
Exemplo: https://apiv3.ideris.com.br/marketplace?offset=10 -
limit: Define o número máximo de itens retornados na busca. O valor máximo permitido é 50.
Exemplo: https://apiv3.ideris.com.br/marketplace?limit=20
-
offset: Define o ponto inicial da busca, útil para paginação.
Nota: Os filtros são opcionais; use-os somente se necessário.
Limite de Chamadas: Este endpoint pode ser chamado até 50 vezes por minuto.
Exemplo de Requisição
Sem filtros:
GET https://apiv3.ideris.com.br/marketplace
Com filtros (offset e limit):
GET https://apiv3.ideris.com.br/marketplace?offset=10&limit=20
Documentação Eletrônica
A documentação completa da API está disponível em um ambiente eletrônico no endereço Swagger.
- Acesso: Não é necessário token para consultar essa documentação.
- Objetivo: Retornar exemplos de objetos padrão, permitindo que você teste as integrações sem precisar de credenciais de acesso.
Se precisar de mais ajuda com este processo, nossa equipe de suporte está pronta para atender você. É só clicar no ícone do whatsapp no canto inferior direito de qualquer página do seu painel Ideris ou abrir um ticket.
Conte sempre conosco. Até a próxima!