Pular para o conteúdo principal
Chame um endpoint conhecido do seu backend por meio da HTTP API. Nenhum Agent é necessário.

​
Chamar um endpoint

Exemplo: receber um nome de usuário do Instagram do seu app e recuperar as publicações públicas mais recentes.
1

Conecte seu backend

URL base: https://api.glasser.ai
Cabeçalho: Authorization: Bearer <your Key>Conta do seu produto: use a Key do seu Workspace.
Conta do seu usuário: selecione a Key desse usuário em cada solicitação.Armazene as Keys no seu backend. Verifique a conexão com uma solicitação gratuita GET /v1/balance.
2

Inspecione o Endpoint uma vez durante a configuração

Envie JSON para POST /v1/endpoints/inspect:
Obtenha: o esquema de entrada e o Price atual. Este endpoint requer username, um array contendo um nome de usuário. A inspeção é gratuita.
3

Chame-o a partir do seu produto

Envie JSON para POST /v1/runs. Use o mesmo cabeçalho de autorização, Content-Type: application/json, e um cabeçalho Idempotency-Key exclusivo para esta execução pretendida.
Substitua mkbhd pela entrada do seu usuário.Obtenha: um Run com id, status e charge_usd. Quando estiver pronto, output conterá até 10 publicações públicas com legendas, contagens de curtidas e contagens de comentários.Para QUEUED ou RUNNING, leia esse Run até que ele atinja um estado terminal. Os Runs usam o saldo do Workspace conectado.
  • Defina endpoint_version a partir de Inspect ou omita-o para usar a versão padrão. Uma versão não fixa o Price; novos Runs usam o Price no momento da admissão.
  • Tente novamente a mesma solicitação com o mesmo Idempotency-Key e a mesma entrada. Continue lendo um Run inacabado em vez de criar outro.
  • Verifique status e provider_response.http_status antes de usar output. Um Run COMPLETED ainda pode conter um erro do provedor de dados.
  • Mantenha o ID do Run e charge_usd junto ao registro da solicitação do seu produto. Um Run com falha ainda pode gerar uma cobrança conforme o Price do endpoint.
  • Mantenha a Key de cada usuário separada. Selecione-a a partir da conexão autenticada do usuário, não dos campos de entrada da solicitação.

​
Consultar APIs de provedores de dados

Escolha um endpoint em Data Sources e faça Inspect para consultar o esquema. Você pode reutilizá-lo sem pesquisar antes de cada Run. Para listar provedores de dados e endpoints no código, use GET /public/catalog. Nenhuma Key é necessária, e as solicitações são gratuitas:
  • providers: nomes e descrições dos provedores de dados e contagens de endpoints.
  • entries: identificadores, descrições, categorias e preços de exibição dos endpoints. Faça a correspondência de provider para encontrar os endpoints de um provedor de dados.
  • Uma resposta: a lista pública completa, sem paginação.
A resposta é armazenada em cache e não aplica a Policy da sua Key. Use Inspect com sua Key para consultar o esquema de entrada e o Price atual do endpoint selecionado antes de executá-lo.

​
Opcional: Solutions

A GTM Solution oferece seis recursos fixos por HTTP. O Glasser gerencia a seleção de endpoints, o mapeamento de entradas e o fallback para falhas compatíveis. Cada Capability tem sua própria API em /v1/solutions/gtm/. Use a mesma Key e um cabeçalho Idempotency-Key; a resposta é um Run. Consulte a visão geral de Solutions para ver um exemplo e as regras de seleção do provedor de dados.