> For the complete documentation index, see [llms.txt](https://docs.ipcheck.ing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipcheck.ing/knowledge-base/pt-br/getting-started/curl-api.md).

# Usando a API do Curl

Obtenha seu endereço IP público diretamente no terminal com curl — IPv4, IPv6 ou o que sua máquina preferir, com geolocalização opcional.

Às vezes você não quer uma página da web. Você quer seu endereço IP em uma janela de terminal ou dentro de um script. O MyIP tem um endpoint em texto puro exatamente para isso.

Dentro do app, você pode abrir este painel clicando no **curl** banner na faixa de produtos perto da parte inferior da página, logo acima do rodapé. O painel se chama **API da Linha de Comando**.

## Os comandos

No site oficial, [ipcheck.ing](https://ipcheck.ing):

```bash
# Obtenha o endereço IPv4 da sua máquina
curl 4.ipcheck.ing

# Obtenha o endereço IPv6 da sua máquina
curl 6.ipcheck.ing

# Obtenha o endereço que sua máquina preferir usar
curl 64.ipcheck.ing
```

Cada domínio responde por apenas um protocolo, e é isso que torna os dois primeiros confiáveis:

* `4.ipcheck.ing` só pode ser acessado via IPv4, então sempre informa seu endereço IPv4.
* `6.ipcheck.ing` só pode ser acessado via IPv6, então sempre informa seu endereço IPv6.
* `64.ipcheck.ing` aceita ambos, então informa aquele que seu sistema escolheu — geralmente IPv6 quando ele está disponível.

{% hint style="info" %}
Se `curl 6.ipcheck.ing` falhar ao conectar, isso já é um resultado: sua rede provavelmente não tem IPv6 funcional. Veja [IPv4 vs IPv6](/knowledge-base/pt-br/concepts/ipv4-vs-ipv6.md).
{% endhint %}

## Adicionando geolocalização

Adicione `/geo` a qualquer um dos três para obter informações geográficas sobre o endereço, em vez do endereço sozinho:

```bash
curl 4.ipcheck.ing/geo
curl 6.ipcheck.ing/geo
curl 64.ipcheck.ing/geo
```

O `/geo` o caminho é opcional. Deixe-o de fora quando quiser apenas o endereço.

## Usando isso em scripts

Como a resposta é texto puro e nada mais, ela entra diretamente em scripts de shell:

```bash
# Armazene seu endereço atual em uma variável
MY_IP=$(curl -s 4.ipcheck.ing)
echo "Endereço atual: $MY_IP"
```

```bash
# Verifique a cada minuto se seu endereço mudou
while true; do
  date
  curl -s 4.ipcheck.ing
  sleep 60
done
```

O `-s` flag faz o curl ficar silencioso sobre seu próprio progresso, o que mantém a saída limpa.

Usos comuns: confirmar que uma VPN está ativa antes de iniciar um trabalho de backup, monitorar uma mudança de IP dinâmico em uma conexão residencial ou registrar qual endereço de saída um servidor está usando.

{% hint style="warning" %}
Por favor, seja razoável sobre com que frequência você chama isso. Este é um serviço gratuito mantido com esforço doado — uma solicitação a cada poucos segundos em um loop receberá limitação de taxa. Uma vez por minuto é suficiente para quase qualquer finalidade.
{% endhint %}

## Verificando a mesma coisa no app

Tudo o que a linha de comando oferece também está no painel, com mais detalhes:

* O **Informações de IP** a seção mostra os mesmos endereços com localização, ISP e número da rede — veja [Lendo seus cartões de IP](/knowledge-base/pt-br/getting-started/reading-your-ip-cards.md).
* Pressione <kbd>q</kbd> para consultar qualquer outro endereço sobre o qual você tenha curiosidade.

## Instâncias auto-hospedadas

Os domínios curl são uma configuração de implantação, não uma parte fixa do MyIP. Quem executa uma cópia do MyIP escolhe seus próprios nomes de domínio para isso, e o painel mostra o que tiver sido configurado. Se nenhum estiver configurado, o painel informa que o recurso não está disponível.

Isso significa:

* O `4.ipcheck.ing`, `6.ipcheck.ing`, e `64.ipcheck.ing` nomes acima pertencem somente ao site oficial.
* Em uma cópia auto-hospedada, abra o **API da Linha de Comando** painel lá para ver os próprios comandos dessa instância.

Para saber como executar sua própria cópia, veja [Sobre o MyIP](/knowledge-base/pt-br/faq/about.md).

## Páginas relacionadas

* [Informações de IP](/knowledge-base/pt-br/connection-tools/ip-information.md)
* [Por que os sites veem um IP diferente?](/knowledge-base/pt-br/diagnose/why-do-sites-see-a-different-ip.md)
* [FAQ geral](/knowledge-base/pt-br/faq/general-faq.md)


---

# 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.ipcheck.ing/knowledge-base/pt-br/getting-started/curl-api.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.