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

# Visão geral

A API de SIM da Eseye permite gerenciar os SIMs em sua infraestrutura global de IoT. Você pode:

* Ativar ou desativar SIMs.
* Recuperar detalhes de um ou vários SIMs.
* Atualizar status, pacotes e portfólios de SIMs.
* Criar, atualizar e excluir atributos de SIMs.
* Ver resumos de faturamento e de rede.

Cada SIM tem um Identificador de Cartão de Circuito Integrado exclusivo de 19 ou 20 dígitos (`iccId`). Os endpoints que atuam em um SIM específico incluem o `iccId` no caminho da requisição. O endpoint de lista também pode aceitar um ou mais `iccId` valores como parâmetros de consulta.

### URL base

Envie requisições de produção para:

```
https://sim.api.anynetiot.com
```

Os endpoints da API de SIM usam `/api/v2`.

### Acesso e autenticação

A API de SIM é gratuita para uso. Você precisa de uma conta Infinity e de uma conta de serviço da API de SIM.

A Eseye provisiona a conta de serviço e fornece seu ID do cliente, segredo do cliente, região e permissões. Solicite acesso enviando um e-mail para [orders@eseye.com](mailto:orders@eseye.com?subject=Request%20SIM%20API). Inclua o nome da sua empresa, cargo, número de telefone e endereço de e-mail.

Toda requisição requer um token de portador OAuth 2.0:

```http
Authorization: Bearer <access-token>
```

Os tokens expiram após uma hora. Siga [Solicitar token de acesso](/api-reference/api-reference-pt-br/authentication/request-access-token.md) para solicitar um token e fazer sua primeira chamada de API.

{% hint style="warning" %}
Teste com SIMs de teste. Alterações na API podem afetar a conectividade e o faturamento em produção.
{% endhint %}

### Comportamento e limitações do SIM

* Um SIM tem um `disponível` ou `ativo` status.
* Um `disponível` SIM não pode se conectar a uma rede e não tem cobranças de serviço.
* Um `ativo` SIM pode se conectar a uma rede. Aplicam-se cobranças padrão de serviço e uso.
* Defina `status` para `disponível` desativar um SIM.
* Suspender um SIM desativa seus serviços, mas não interrompe as cobranças de serviço.
* Você não pode fazer alterações em um SIM suspenso.
* SIMs não podem ser criados por meio da API. A Eseye fornece os SIMs e os vincula à sua conta.
* Os endpoints da API de SIM atualizam um SIM por vez. Para alterações suportadas em vários SIMs, consulte o [API de Operações em Massa](/api-reference/api-reference-pt-br/api-de-operacoes-em-massa/overview.md).
* A pesquisa em texto livre não é suportada. Adicione atributos para categorizar e encontrar SIMs.

### Suporte

Contato [Suporte da Eseye](mailto:support@eseye.com?subject=API%20support%20request) para obter suporte da API.


---

# 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.eseye.com/api-reference/api-reference-pt-br/api-de-sim/overview.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.