> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-api/caf-api-pt-br/connect/getting_started.md).

# Como começar

Bem-vindo! Este guia ajudará você a começar a usar a Connect API, desde criar sua primeira aplicação até fazer solicitações autenticadas e entender permissões.

## Etapa 1: Crie uma aplicação

Para usar as APIs, primeiro você precisa criar uma aplicação em [Trust](https://trust.caf.io/). Você receberá um `client_id` e `client_secret`.

* Acesso [Criando uma aplicação](/caf-api/caf-api-pt-br/connect/authentication/applications/creating-application.md) para instruções passo a passo.

## Etapa 2: Entenda as permissões

Sua aplicação requer permissões específicas para acessar diferentes recursos da API. Revise e selecione as permissões necessárias para seu caso de uso.

* Acesso [Permissões disponíveis](/caf-api/caf-api-pt-br/connect/authentication/applications/available-permissions.md) para a lista completa.

## Etapa 3: Autentique-se e obtenha um token de acesso

Com suas credenciais, você pode se autenticar e obter um token de acesso OAuth2. Esse token é necessário para todas as solicitações à API.

* Saiba como se autenticar em [Autenticação](/caf-api/caf-api-pt-br/connect/authentication/authenticating.md).

## Etapa 4: Configure a autenticação TLS mútuo (mTLS) (recomendado)

Para maior segurança, a Connect oferece suporte à autenticação TLS mútuo (mTLS). Isso fornece uma camada adicional de segurança ao exigir que tanto o cliente quanto o servidor verifiquem os certificados um do outro.

1. **Criar um certificado**:
   * Siga as instruções em [Criando um certificado](/caf-api/caf-api-pt-br/connect/authentication/certificates/creating-certificate.md) para gerar um certificado de cliente.
2. **Configure o mTLS em sua aplicação**:
   * Implemente a autenticação mTLS usando seu certificado e chave privada.
   * Acesso [Usando mTLS](/caf-api/caf-api-pt-br/connect/authentication/using-mtls.md) para exemplos de código e instruções detalhadas.

## Próximos passos

* Explore o [Recursos Disponíveis](/caf-api/caf-api-pt-br/connect/available-resources.md) para ver o que você pode fazer com a API.
* Revise [Gerenciando aplicações](/caf-api/caf-api-pt-br/connect/authentication/applications/managing-applications.md) para dicas sobre atualizar ou excluir suas aplicações.
* Saiba mais sobre [Gerenciamento de certificados](/caf-api/caf-api-pt-br/connect/authentication/certificates/managing-certificate.md) para lidar com renovação e revogação de certificados.

> **Dica:** Mantenha suas credenciais e certificados seguros e nunca os exponha em código do lado do cliente ou em repositórios públicos.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.caf.io/caf-api/caf-api-pt-br/connect/getting_started.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.