Parent Collections

Na Kondado, Parent Collections são os conectores e destinos que podem ser adicionados por usuários da nossa plataforma.

Listar conectores disponíveis para criação

Descrição

Lista os conectores disponíveis para criação para o usuário. Este endpoint não deve ser confundido com o endpoint que lista os conectores que o usuário criou

Método

GET

Endpoint

/parent_collections/src

Parâmetros da URL

Nenhum

Exemplo de resposta

{
    "success": true,
    "data": [
        {
         "id": 76,
         "createdAt": "2020-06-30T23:30:56.904Z",
         "updatedAt": "2020-06-30T23:30:56.904Z",
         "parent_collection_name": "Salesforce Marketing Cloud",
         "parent_collection_image": "https://kondado.com.br/assets/images/conectores_salesforcemarketingcloud.png",
         "_links": {
             "src": {
                 "tutorial": "https://kondado.com.br/blog/como-adicionar-o-conector-do-salesforce-marketing-cloud-na-kondado/"
             }
         }
     }
    ]
}

Descrição do retorno

ID do registro

createdAt

Data de criação do registro

updatedAt

Data de atualização do registro

parent_collection_name

Nome do conector

parent_collection_image

Link da imagem do logo do conector

_links

JSON com os links relacionados ao registro. Como algumas collections podem ser conectores (src) e destinos (dest) ao mesmo tempo (por exemplo, o postgresql) os links estarão separados no JSON nas chaves src e dest.

O JSON src/dest conterá a chave que descreve o link e como valor o link em si, por exemplo:

"tutorial": "https://kondado.com.br/blog/como-adicionar-o-conector-do-salesforce-marketing-cloud-na-kondado/"

Listar destinos disponíveis para criação

Descrição

Lista os destinos disponíveis para criação para o usuário. Este endpoint não deve ser confundido com o endpoint que lista os destinos que o usuário criou.

Método

GET

Endpoint

/parent_collections/dest

Parâmetros da URL

Nenhum

Exemplo de resposta

{
    "success": true,
    "data": [
        {
         "id": 20,
         "parent_collection_image": "https://kondado.com.br/assets/images/conectores_bigquery.png",
         "parent_collection_name": "BigQuery",
         "_links": {
             "src": {
                 "tutorial": "https://www.kondado.com.br/blog/como-adicionar-o-conector-do-bigquery-na-kondado/"
             },
             "dest": {
                 "tutorial": "https://kondado.com.br/blog/adicionando-o-bigquery-como-destino-na-plataforma-da-kondado/"
             }
         },
         "createdAt": "2019-03-24T21:26:41.134Z",
         "updatedAt": "2019-03-24T21:26:41.134Z"
     }
    ]
}

Descrição do retorno

ID do registro

createdAt

Data de criação do registro

updatedAt

Data de atualização do registro

parent_collection_name

Nome do conector

parent_collection_image

Link da imagem do logo do destino

_links

O JSON src/dest conterá a chave que descreve o link e como valor o link em si, por exemplo:

"tutorial": "https://kondado.com.br/blog/como-adicionar-o-conector-do-salesforce-marketing-cloud-na-kondado/"

Interagir com Parent Collections via API da Kondado

Aprenda a listar conectores e destinos disponíveis para criação usando os endpoints de Parent Collections da API Kondado.

Obter acesso à API da Kondado

Certifique-se de ter uma conta ativa na plataforma. Se ainda não tiver, crie sua conta gratuita para começar a usar a API.

Listar conectores disponíveis

Faça uma requisição GET para o endpoint /parent_collections/src. Este endpoint retorna todos os conectores disponíveis que podem ser adicionados, com dados como id, nome, imagem e links relacionados.

Listar destinos disponíveis

Faça uma requisição GET para o endpoint /parent_collections/dest. Este endpoint retorna todos os destinos disponíveis para criação, incluindo collections que funcionam tanto como conector quanto como destino.

Interpretar o campo _links

Analise o JSON de resposta atentamente: o campo _links contém subchaves src e dest quando a collection serve para ambos. Cada subchave mapeia descrições (ex: "tutorial") para URLs úteis.

Diferenciar endpoints de listagem

Lembre-se: /parent_collections/src e /parent_collections/dest listam o que está disponível para criar, não o que o usuário já criou. Não confunda com os endpoints que listam collections já instanciadas.

Perguntas frequentes

Qual a diferença entre Parent Collections e as collections que já criei na minha conta?▼

Parent Collections são os conectores e destinos disponíveis na plataforma para você adicionar. Os endpoints /parent_collections/src e /parent_collections/dest listam o que pode ser criado, enquanto outros endpoints listam as instâncias que você já configurou em sua conta.

Por que algumas Parent Collections têm tanto src quanto dest no campo _links?▼

Algumas collections, como o PostgreSQL, funcionam tanto como conector (src) quanto como destino (dest). Por isso, o campo _links separa os links em subchaves src e dest, cada uma com seus próprios recursos — por exemplo, tutoriais diferentes para adicionar como origem ou como destino.

O que significa o campo parent_collection_image na resposta da API?▼

O campo parent_collection_image contém o link direto para o logo do conector ou destino, hospedado nos assets da Kondado. Você pode usar essa URL para exibir visualmente as integrações disponíveis em sua aplicação.

Posso usar a API de Parent Collections sem ter uma conta na Kondado?▼

Não. Para autenticar e executar requisições nos endpoints da API, você precisa de uma conta ativa na plataforma. Crie sua conta gratuita para obter as credenciais de acesso.

Como identificar se um conector também serve como destino pela API?▼

Quando uma collection é dual (funciona como ambos), a resposta da API incluirá tanto a subchave src quanto dest dentro de _links. Se você consultar /parent_collections/src e /parent_collections/dest, verá a mesma collection aparecendo em ambos, como é o caso do BigQuery e PostgreSQL.

Escrito por

Thassyo Pereira·Publicado em 2020-09-20·Atualizado em 2026-04-25