SDK/API/Embedded
6 min
sdk, embedded e api 🚧 página em construção esta documentação está sendo expandida em breve traremos guias detalhados de implementação, exemplos por linguagem e referência completa por enquanto, esta página descreve o panorama geral e aponta para os recursos disponíveis hoje objetivo esta seção é o ponto de entrada para times de engenharia que vão integrar a fluid dentro do próprio produto — emitindo tokens para usuários finais, embutindo o canvas em uma aplicação existente ou chamando a api administrativa para automatizar a operação da plataforma se você só vai criar fluxos e conexões pelo console, não precisa desta página comece por primeiros passos https //docs fluidapi io/primeiros passos quando usar cada caminho a fluid oferece três caminhos de integração programática, todos autenticados por credenciais https //docs fluidapi io/credenciais caminho quando usar tipo de credencial sdk seu backend precisa emitir tokens de usuário para ativar flowkits e integrações dentro do seu produto sdk embedded você quer renderizar o canvas da fluid embutido na interface do seu produto, já autenticado para o usuário correto embedded api seu sistema fala direto com a api administrativa da fluid para provisionar workspaces, gerenciar membros ou automatizar operações de plataforma api os três compartilham a mesma base de autenticação oauth2 client credentials a diferença está no que cada token autoriza fazer pré requisitos independentemente do caminho escolhido, você vai precisar de uma credencial criada no console, com o tipo correspondente ao seu caso de uso o client id e o client secret dessa credencial, armazenados em variável de ambiente ou secret manager no seu backend acesso ao fluid playground https //playground fluidapi io/ para validar o fluxo antes de implementar consulte a página de credenciais https //docs fluidapi io/credenciais para o passo a passo de criação e gestão testando antes de implementar antes de escrever qualquer linha de código no seu backend, valide o fluxo de autenticação no fluid workbench ele permite executar a cadeia completa — client credentials → token m2m → bootstrap token → sessão — direto pela interface, sem dependências útil para confirmar que sua credencial está configurada corretamente, inspecionar a estrutura dos tokens retornados e isolar problemas antes de partir para o código use o workbench para confirmar que sua credencial está configurada corretamente inspecionar a estrutura dos tokens retornados reproduzir o fluxo de ponta a ponta antes de levar para produção isolar problemas se funciona no workbench e não no seu código, o problema está no código acesse o workbench em configurações → credenciais → workbench o que vem por aí estamos preparando guias dedicados para cada caminho, incluindo instalação e setup do @fluidapi/sdk exemplos completos em node js, python e go referência de eventos e callbacks do embedded catálogo de endpoints da api administrativa tratamento de erros e troubleshooting enquanto isso, se precisar de orientação técnica para sua integração, abra um chamado pelo portal de chamados https //docs fluidapi io/portal de chamados ou fale com seu customer success manager links relacionados credenciais https //docs fluidapi io/credenciais — como criar e gerenciar credenciais m2m customers https //docs fluidapi io/customers — vínculo entre tokens emitidos e organizações dos seus usuários finais api keys https //docs fluidapi io/api keys — alternativa para webhooks e disparos passivos gateway fluid https //docs fluidapi io/gateway fluid — endpoints de disparo de fluxo