> 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/fr/getting-started/curl-api.md).

# Utiliser l’API Curl

Parfois, vous ne voulez pas d'une page web. Vous voulez votre adresse IP dans une fenêtre de terminal, ou dans un script. MyIP propose un point de terminaison en texte brut exactement pour cela.

Dans l'application, vous pouvez ouvrir ce panneau en cliquant sur le **curl** bannière dans la barre de produits près du bas de la page, juste au-dessus du pied de page. Le panneau est intitulé **API de ligne de commande**.

## Les commandes

Sur le site officiel, [ipcheck.ing](https://ipcheck.ing):

```bash
# Obtenez l'adresse IPv4 de votre machine
curl 4.ipcheck.ing

# Obtenez l'adresse IPv6 de votre machine
curl 6.ipcheck.ing

# Obtenez l'adresse que votre machine préfère utiliser
curl 64.ipcheck.ing
```

Chaque domaine répond via un seul protocole, ce qui rend les deux premiers fiables :

* `4.ipcheck.ing` ne peut être atteint qu'en IPv4, donc il renvoie toujours votre adresse IPv4.
* `6.ipcheck.ing` ne peut être atteint qu'en IPv6, donc il renvoie toujours votre adresse IPv6.
* `64.ipcheck.ing` accepte les deux, donc il renvoie celui que votre système a choisi — généralement IPv6 lorsqu'il est disponible.

{% hint style="info" %}
Si `curl 6.ipcheck.ing` échoue à se connecter, c'est en soi un résultat : votre réseau ne dispose probablement pas d'un IPv6 fonctionnel. Voir [IPv4 contre IPv6](/knowledge-base/fr/concepts/ipv4-vs-ipv6.md).
{% endhint %}

## Ajout de la géolocalisation

Ajoutez `/geo` à l'un des trois pour obtenir des informations géographiques sur l'adresse plutôt que l'adresse seule :

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

Le `/geo` chemin est facultatif. Omettez-le lorsque vous ne voulez que l'adresse.

## Utilisation dans des scripts

Comme la réponse est en texte brut et rien d'autre, elle s'intègre directement dans des scripts shell :

```bash
# Enregistrez votre adresse actuelle dans une variable
MY_IP=$(curl -s 4.ipcheck.ing)
echo "Adresse actuelle : $MY_IP"
```

```bash
# Vérifiez toutes les minutes si votre adresse a changé
while true; do
  date
  curl -s 4.ipcheck.ing
  sleep 60
done
```

Le `-s` l'option indique à curl de rester silencieux au sujet de sa propre progression, ce qui garde la sortie propre.

Cas d'usage courants : vérifier qu'un VPN est actif avant de lancer une tâche de sauvegarde, surveiller un changement d'IP dynamique sur une connexion domestique, ou consigner quelle adresse de sortie un serveur utilise.

{% hint style="warning" %}
Veuillez faire preuve de discernement quant à la fréquence d'utilisation. C'est un service gratuit fonctionnant grâce à un effort bénévole — une requête toutes les quelques secondes depuis une boucle sera soumise à une limitation de débit. Une fois par minute suffit amplement pour presque tous les usages.
{% endhint %}

## Vérifier la même chose dans l'application

Tout ce que la ligne de commande vous donne est aussi disponible sur le tableau de bord, avec plus de détails :

* Le **Infos IP** La section montre les mêmes adresses avec la localisation, le FAI et le numéro de réseau — voir [Lire vos cartes IP](/knowledge-base/fr/getting-started/reading-your-ip-cards.md).
* Appuyez sur <kbd>q</kbd> pour rechercher toute autre adresse qui vous intéresse.

## Instances auto-hébergées

Les domaines curl sont un paramètre de déploiement, pas une partie fixe de MyIP. Quiconque exécute une copie de MyIP choisit ses propres noms de domaine pour celle-ci, et le panneau affiche ce qui a été configuré. Si rien n'est configuré, le panneau indique que la fonctionnalité n'est pas disponible.

Cela signifie :

* Le `4.ipcheck.ing`, `6.ipcheck.ing`, et `64.ipcheck.ing` les noms ci-dessus appartiennent uniquement au site officiel.
* Sur une copie auto-hébergée, ouvrez le **API de ligne de commande** panneau là-bas pour voir les propres commandes de cette instance.

Pour savoir comment exécuter votre propre copie, voir [À propos de MyIP](/knowledge-base/fr/faq/about.md).

## Pages associées

* [Informations IP](/knowledge-base/fr/connection-tools/ip-information.md)
* [Pourquoi les sites voient-ils une IP différente ?](/knowledge-base/fr/diagnose/why-do-sites-see-a-different-ip.md)
* [FAQ générale](/knowledge-base/fr/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/fr/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.