Conectores
Core
Fluid GraphQL API
10min
introdução o conector fluid graphql api permite a interação com as apis graphql da fluid de maneira eficiente, permitindo consultas e mutações de dados para as apis disponibilizadas para nosso console web funcionalidades principais consultas e mutations permite realizar queries e mutations nas apis graphql fornecidas pela fluid configuração de template facilita a criação e manutenção de templates para montagem da query para consultas complexas autenticação o conector fluid graphql api utiliza autenticação baseada em chave api para garantir a segurança das suas requisições crie a api keys docid\ u9rzulsup oxxcqf5mu 8 no seu workspace configuração do conector parâmetros de configuração operação define a operação a ser realizada ( query ) template área onde você pode definir e editar o template da consulta ou mutação graphql exemplo de template de query nesse exemplo é possível recuperar os dados de uma conexão criada com o nome especificado query ($filter connectionfilter) { data allconnections(filter $filter) { id name status total count } } { "variables" { "filter" { "name" "vtex loja principal" } } } guia de utilização passo a passo para configuração selecionar operação escolha query para a requisição às nossas apis graphql da fluid definir template utilize a aba template para inserir a consulta graphql desejada você pode utilizar variáveis e parâmetros para tornar a consulta dinâmica exemplo de configuração busca de requisições entre datas neste exemplo, efetuaremos uma busca de requisiçoes entre o dia 10/09/2024 e 11/09/2024 primeiro, adiciono o conector fluid graphql api ao canvas para isso basta arrastá lo em seguida, navego até template docid\ treajh8tvdyh6ukyeaqzp , agora adiciono a query que quero executar { "query" "\n query (\n $page int\n $perpage int\n $sortfield string\n $sortorder string\n $filter requestfilter\n ) {\n data allrequests(\n page $page\n perpage $perpage\n sortfield $sortfield\n sortorder $sortorder\n filter $filter\n ) {\n \n hash\n timestamp\n duration\n status\n engine {\n step\n flow name\n tags\n}\n\n }\n\n total allrequestsmeta(page $page, perpage $perpage, filter $filter) {\n count\n typename\n }\n }\n", "variables" { "page" 0, "perpage" 10, "sortfield" "timestamp", "sortorder" "desc", "filter" { "from" "2024 09 10t00 00 00 03 00", "to" "2024 09 11t23 59 59 03 00" } } } adiciono o tipo da operação (neste caso query ) agora, propriedades, também preciso adicionar conexões docid\ fdr1y5srgt0dnlvqkuekj , com a configuração de tenant e api key docid\ vojxrxx nflvlcqizn7hk para a autorização de busca desses dados pronto! agora sua primeira operação com o conector fluid graphql api docid 3b2rczbcfirag1lbkyxg1 está pronta continue usando e testando novas formas de integrar e lembre se sempre de consultar outros tópicos da nossa documentação melhores práticas utilização de variáveis utilize as respostas de outros passos para criar queries dinâmicas e poderosas retorne o que precisar para uma melhor performance, aproveite o poder do graphql e defina exatamente os campos que precisará na resposta conclusão o conector fluid graphql api simplifica a interação com os serviços graphql da fluid, permitindo a realização de consultas e mutações de forma eficiente e configurável com uma interface intuitiva e a capacidade de definir templates personalizados, este conector é uma ferramenta poderosa para as apis disponibilizadas pela fluid para integrações modernas