# 2. Assinatura GraphQL

O diagrama de sequência para Subscriptions GraphQL ilustra como tirar proveito da arquitetura orientada a eventos implementada no core do GeoPard. Diante de quaisquer alterações nas entidades vinculadas, o

API do GeoPard emite prontamente um evento capturando as entidades impactadas e a operação correspondente (`INSERIR`, `MODIFICAR`, `REMOVER`). O escopo dessas subscriptions é amplo, cobrindo todas as entidades como Fazenda, Talhão, Imagem de Satélite, Conjunto de Dados de Solo, Conjunto de Dados AsApplied, Conjunto de Dados de Produtividade, Mapa de Topografia, Notas, etc. 

A Subscription GraphQL ([Solicitação 1 ou R1](/geopard-tutorials/pt-br/docs-da-api/visao-geral-das-solicitacoes-da-api-do-geopard/1.-assinatura-obter-eventos.md)) opera em um WebSocket onde 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 subscription deve funcionar como um serviço básico, responsável por encaminhar os eventos recebidos para um serviço subsequente onde a lógica de processamento é aplicada. É crucial que esse receptor não realize nenhuma tarefa de processamento por si só.
{% endhint %}

Além disso, caso haja quaisquer eventos perdidos ou extraviados, os usuários têm a capacidade de recuperá-los. Isso é alcançado executando uma consulta GraphQL ajustada para um intervalo de datas e entidades específicas (Usuário, Fazenda, Talhão), possibilitando efetivamente a recuperação completa de eventos passados ([Solicitação 2 ou R2](/geopard-tutorials/pt-br/docs-da-api/visao-geral-das-solicitacoes-da-api-do-geopard/82.-mutacao-restaurar-eventos-de-assinatura.md)). Esse nível de funcionalidade assegura que nenhuma informação seja perdida, mantendo a integridade e a consistência dos dados do usuário.

<figure><img src="/files/8f3da44b7581f065b294e703ef971922671789e6" alt=""><figcaption><p>Diagrama de sequência: Trabalhando com Eventos de Subscription</p></figcaption></figure>


---

# 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://docs.geopard.tech/geopard-tutorials/pt-br/docs-da-api/diagramas-com-fluxos-basicos/2.-assinatura-graphql.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.