Pular para o conteúdo principal
Use dados pagos de provedores de dados especializados em seu próprio aplicativo com uma única Key e saldo da Glasser. Cada Endpoint é uma operação de um provedor de dados, como enriquecimento de empresas ou pesquisa de palavras-chave. Pesquise nas fontes de dados, inspecione as entradas e o preço de um Endpoint e execute-o para obter os dados do provedor de dados. Para entender o fluxo de dados e escolher como seu produto se conectará, comece por Integrações.

​
Autenticar

A URL base da API é https://api.glasser.ai. As solicitações para /v1 precisam de uma Key. Crie uma em Keys e defina-a como GLASSER_API_KEY no seu ambiente. Envie-a no cabeçalho Authorization: Bearer. Verifique sua conexão com esta solicitação gratuita de saldo:

​
Limites de taxa

Nosso limite de taxa atual é de 600 solicitações por minuto por chave de API, por rota da API. Liste provedores de dados e Endpoints com GET /public/catalog. Esta solicitação pública e gratuita não precisa de Key e retorna a lista completa em uma única resposta: providers descreve cada provedor de dados; entries lista seus Endpoints e preços de exibição. Use-a para escolher um Endpoint durante o desenvolvimento ou criar um seletor de provedores de dados. A lista é armazenada em cache e não aplica a Política da sua Key. Inspecione o Endpoint escolhido com sua Key para consultar o esquema e o preço atual.

​
Pesquisar, inspecionar e executar

  1. Pesquisar Endpoints. Encontre dados para sua tarefa. Use query para termos de pesquisa, como company enrichment, e inclua o use_case obrigatório, como Create a company profile for glasser.ai. Os resultados identificam o provedor de dados, o Endpoint e a versão do Endpoint, com seu preço.
  2. Inspecionar o Endpoint. Leia seu input_schema, a entrada de exemplo e o preço, incluindo as regras de cobrança para cada resultado. Use este esquema para criar a entrada do provedor de dados.
  3. Executar o Endpoint. Envie o provider e o endpoint selecionados, com a entrada criada, para POST /v1/runs. Isso cria um Run e recupera os dados de acordo com as regras de cobrança desse Endpoint.
A pesquisa e a inspeção são gratuitas. Criar um Run exige um cabeçalho Idempotency-Key. Mantenha o mesmo valor ao tentar novamente a mesma solicitação; use um valor novo para uma nova execução.

​
Ler o resultado

Uma solicitação de dados retorna um Run. Leia estes campos antes de usar o resultado: Um Run pode retornar HTTP 200 com status: "COMPLETED" mesmo quando o provedor de dados rejeita a solicitação. Nesse caso, output é null; leia o status e o corpo do erro do provedor de dados em provider_response. As listas de Run contêm apenas resumos; use Obter um Run para ver os detalhes completos do erro. Tentar novamente um Run concluído com o mesmo Idempotency-Key e a mesma entrada retorna o mesmo resultado sem outra chamada ao provedor de dados. Use uma nova chave para outra tentativa, incluindo uma solicitação com entrada revisada. Consulte Como funciona para conhecer os estados de Run, preços e novas tentativas.

​
Soluções para tarefas comuns

As soluções oferecem um caminho mais curto para solicitações comuns. Por exemplo, company_intelligence aceita um domínio, depois a Glasser seleciona um Endpoint e converte a entrada para o provedor de dados. Use-a quando os parâmetros disponíveis da Glasser atenderem à sua tarefa. Ela usa a mesma Key e o mesmo saldo e retorna um Run comum. Consulte a visão geral das soluções para conhecer os recursos disponíveis, a seleção de provedores de dados e as cobranças.