> For the complete documentation index, see [llms.txt](https://docs.geopard.tech/geopard-tutorials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geopard.tech/geopard-tutorials/pt-br/documentacao-da-api/diagrams-with-basic-flows/2.-graphql-subscription.md).

# 2. Assinatura GraphQL

O diagrama de sequência das assinaturas GraphQL ilustra como aproveitar a arquitetura orientada a eventos implementada no núcleo do GeoPard. Sempre que houver alterações nas entidades vinculadas, a

API do GeoPard emite prontamente um evento que registra as entidades afetadas e a operação correspondente (`INSERT`, `MODIFY`, `REMOVE`). O escopo dessas assinaturas é amplo e abrange todas as entidades, como Farm, Field, SatelliteImage, SoilDataset, AsAppliedDataset, YieldDataset, TopographyMap, Notes etc.

A assinatura GraphQL ([Solicitação 1 ou R1](https://docs.geopard.tech/geopard-tutorials/pt-br/documentacao-da-api/geopard-api-requests-overview/1.-subscription-get-events.md)) funciona por meio de um WebSocket, pelo qual todos os eventos são entregues quase em tempo real, garantindo a comunicação imediata de quaisquer alterações.

{% hint style="danger" %}
O receptor dos eventos da assinatura deve funcionar como um serviço básico, responsável por encaminhar os eventos recebidos a um serviço subsequente, onde a lógica de processamento é aplicada. É fundamental que esse receptor não execute nenhuma tarefa de processamento.
{% endhint %}

Além disso, caso algum evento não seja recebido ou seja perdido, os usuários podem recuperá-lo. Isso é feito executando uma consulta GraphQL direcionada a um intervalo de datas e a entidades específicas (User, Farm, Field), permitindo recuperar completamente os eventos anteriores ([Solicitação 2 ou R2](https://docs.geopard.tech/geopard-tutorials/pt-br/documentacao-da-api/geopard-api-requests-overview/82.-query-restore-subscription-events.md)). Esse nível de funcionalidade garante que nenhuma informação seja perdida, mantendo a integridade e a consistência dos dados do usuário.

<figure><img src="https://1397135423-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2F8YoTw2Od4ykqav13zGp4%2Fimage.png?alt=media&amp;token=f9ba66ec-8172-40c6-a3b6-36fc0ecbb24b" alt=""><figcaption><p>Diagrama de sequência: Trabalhar com eventos de assinatura</p></figcaption></figure>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.geopard.tech/geopard-tutorials/pt-br/documentacao-da-api/diagrams-with-basic-flows/2.-graphql-subscription.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
