> ## Documentation Index
> Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral da API

> Conecte-se com uma Key, pesquise e inspecione Endpoints, depois execute uma solicitação e leia o resultado.

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](https://glasser.ai/docs/pt/integrations/overview.md).

## Autenticar

A URL base da API é `https://api.glasser.ai`. As solicitações para `/v1` precisam de uma Key. Crie uma em
[Keys](https://app.glasser.ai/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:

```bash theme={null}
curl --request GET \
  --url https://api.glasser.ai/v1/balance \
  --header "Authorization: Bearer $GLASSER_API_KEY"
```

## Limites de taxa

Nosso limite de taxa atual é de **600 solicitações por minuto por chave de API, por rota da API**.

## Navegar por provedores de dados e Endpoints

[Liste provedores de dados e Endpoints](https://glasser.ai/docs/pt/api-reference/endpoints/list.md) 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](https://glasser.ai/docs/pt/api-reference/endpoints/search.md).** 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](https://glasser.ai/docs/pt/api-reference/endpoints/inspect.md).** 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](https://glasser.ai/docs/pt/api-reference/runs/create.md).** 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:

| Campo | O que verificar |
| - | - |
| `status` | O Run foi concluído? Para uma resposta `202`, use [Obter um Run](https://glasser.ai/docs/pt/api-reference/runs/get.md) para verificar novamente. |
| `provider_response.http_status` | O provedor de dados retornou dados ou um erro? `COMPLETED` pode incluir um erro do provedor de dados. |
| `provider_response.error` | O corpo do erro do provedor de dados quando a resposta dele não é bem-sucedida. |
| `output` | Os dados do provedor de dados em uma resposta bem-sucedida. |
| `charge_usd` | A cobrança deste Run, independentemente do status. |
| `run_url` | Abra o Run no seu Workspace. |

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](https://glasser.ai/docs/pt/api-reference/runs/get.md) 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](https://glasser.ai/docs/pt/how-it-works.md) 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](https://glasser.ai/docs/pt/api-reference/solutions/overview.md) para conhecer os recursos disponíveis,
a seleção de provedores de dados e as cobranças.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.