--- title: "How to Use the Table API" slug: "how-to-use-the-table-api" updated: 2025-01-08T14:13:24Z published: 2025-01-08T14:13:24Z canonical: "support.tulip.co/how-to-use-the-table-api" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Como usar a API de tabela *Configure e use a API da Tulip para interagir com a Tulip a partir de outros sistemas.* Advanced Content This article assumes previous experience with APIs. A Tulip interage com muitas APIs de outros sistemas por meio de conectores. Usando [conectores](https://support.tulip.co/docs/what-are-connectors), um aplicativo Tulip pode iniciar uma consulta HTTP ou SQL. Em outros casos, você pode querer permitir que um sistema externo consulte dados que só existem na Tulip. É possível se comunicar com a Tulip a partir de sistemas externos usando a API da Tulip. Este artigo abordará a configuração e os testes da API da Tulip. A API da Tulip é útil para integrar esses sistemas externos com a Tulip, por meio das [tabelas](https://support.tulip.co/r230/docs/an-overview-of-tables) da Tulip. Isso inclui atualizar um registro de tabela com novas informações, criar uma tabela ou obter a contagem de registros em uma tabela. ## Exemplos Os exemplos a seguir mostram o processo para fazer solicitações à API da Tulip. Esses exemplos usam o Postman para fazer as solicitações do Tulip. ### Obter nomes e informações de tabelas Essa solicitação GET permite que o sistema externo recupere os IDs e as informações de coluna de todas as tabelas dentro da instância da Tulip. Isso pode ser útil como um método para encontrar uma tabela de interesse a fim de configurar uma solicitação POST. No Postman, defina a Autorização como **Basic Auth** e insira a **Chave** e o **Segredo** **da API**. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Use%20the%20Table%20API_206188425.png) Agora, a solicitação precisa ir para o lugar certo. No Tulip, encontre a solicitação que você deseja fazer na documentação da API. Nesse caso, a solicitação é para obter todas as informações da tabela. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Use%20the%20Table%20API_206188941.png) Para obter o URL da solicitação, execute o botão **Execute (Executar** ) e verifique as informações da solicitação. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Use%20the%20Table%20API_206477530.png) Esse URL de solicitação pode ser usado como o URL do servidor para processar a solicitação GET do Postman. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Use%20the%20Table%20API_206477936.png) Clique em **Send (Enviar)** e a solicitação retornará todas as informações das tabelas. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Use%20the%20Table%20API_206189542.png) ### Criar um registro de tabela Usando um POST e o ID da tabela encontrado acima, um registro de tabela pode ser criado a partir do sistema externo. A autorização e o cabeçalho permanecerão os mesmos, mas o URL da solicitação será um pouco diferente. Primeiro, determine a tabela na qual deseja criar um registro. O URL de solicitação sempre obedecerá à seguinte estrutura: NOTE If you are using a global API key, you need to specify the workspace. If your API key is workspaced scoped, it is optional. *https://(yourinstancenamehere).tulip.co/api/v3/w/(workspace)/tables/(TableID)/records* ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Use%20the%20Table%20API_206478239.png) Uma vez inserida, a solicitação também precisará de um corpo para processar o POST corretamente. O esquema de colunas é fornecido acima na seção Testes e pode ser encontrado na documentação da API. A única coluna que é totalmente necessária para que isso seja bem-sucedido é a coluna ID. Todas as outras colunas que não forem adicionadas serão armazenadas como nulas no registro da tabela após a criação. Adicione este conteúdo como um corpo para a solicitação. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Use%20the%20Table%20API_206191458.png) No envio, o Postman verifica se o registro foi criado. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Use%20the%20Table%20API_206191590.png) --- Encontrou o que estava procurando? Você também pode acessar [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) para postar sua pergunta ou ver se outras pessoas tiveram uma pergunta semelhante!