# Bem-vindo(a)!

Essa é canal oficial para a documentação das nossas APIs e notificações, onde disponibilizaremos todas as informações necessárias para que seja possível o consumo, inserção e atualização de dados na nossa plataforma e no seu sistema.

## Quer entender um pouco mais?

A nossa API é baseada no modelo de arquitetura **`REST`** e segue as boas práticas propostas por essa referência.

Comece a explorar as nossas referências de API para entender tudo o que é possível fazer dentro da nossa platatorma.

{% content-ref url="api-docs/v1" %}
[v1](https://developers.estoca.com.br/api-docs/v1)
{% endcontent-ref %}

{% content-ref url="<https://github.com/Estoca/estoca-gitbook-api-docs/blob/master/api-docs/v1.1>" %}
<https://github.com/Estoca/estoca-gitbook-api-docs/blob/master/api-docs/v1.1>
{% endcontent-ref %}

Disponibilizamos também algumas notificações, através de **`Webhooks`**, para que o seu sistema receba a atualização de eventos que ocorreram na nossa plataforma. Com isso, o seu sistema não precisará consultar a nossa API periodicamente e apenas acessá-la quando se fizer necessário.

{% content-ref url="notifications-docs/v1" %}
[v1](https://developers.estoca.com.br/notifications-docs/v1)
{% endcontent-ref %}

## Além disso tudo...

Também é muito importante que o seu time realize o acompanhamento periódico do nosso histórico de alterações dessa documentação.

{% content-ref url="others/changelogs" %}
[changelogs](https://developers.estoca.com.br/others/changelogs)
{% endcontent-ref %}


---

# Agent Instructions: 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:

```
GET https://developers.estoca.com.br/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.