> 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 seu parque 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 SIM.
* Visualizar instantâneos de faturamento e rede.

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

### URL base

Envie solicitaçõ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 de 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 solicitaçã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 à API.

{% hint style="warning" %}
Teste com SIMs de teste. Alterações na API podem afetar a conectividade ao vivo e o faturamento.
{% 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 possui 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` para 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 por 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 assistência com a 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 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.eseye.com/api-reference/api-reference-pt-br/api-de-sim/overview.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.
