> For the complete documentation index, see [llms.txt](https://doc.ankabot.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.ankabot.dev/autres/api-archi.md).

# API Archi-Monstre

Cette API vous permettra de connaitre si un archi-monstre est présent dans un serveur de jeu.

{% hint style="danger" %}
À partir de **12 Octobre 2021**, cette API n'est plus disponible, et l'utilisation de l'abonnement archi-monstres est interdit aux bots.
{% endhint %}

## Introduction

Dès qu'un bot rencontre un archi-monstre sur un serveur de jeu, une notification est envoyée dans notre serveur Discord, de plus l'heure, le serveur et la position de l'archi-monstre sont enregistrés dans notre base de données, pour vous permettre de vérifier si un archi-monstre a été présent dans un serveur de jeu.

{% content-ref url="/pages/-MkQQTA7CRR2JMGKSqJ-" %}
[Rejoindre notre Discord](/rejoindre-notre-discord.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MbxA\_81\_MoFaSm-lP6W" %}
[Abonnement](/abonnement.md)
{% endcontent-ref %}

## Comment ça marche ?

Il suffit de vous rendre sur le lien suivant :

{% hint style="info" %}
<https://www.ankabot.dev/API/ArchiMonsters.php>?key=**K**\&serveur=**X**\&last=**T**
{% endhint %}

### Paramètres :

| Paramètre | Description                                 |
| --------- | ------------------------------------------- |
| **`K`**   | Votre clé **AnkaBot**.                      |
| **`X`**   | Le nom du serveur à vérifier.               |
| **`T`**   | Le nombre des dernières minutes à vérifier. |

### Réponses :

| Type de réponse | Description                                                                                                                                                                                                                                                                               |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`JSON`**      | <p>Une chaine au format <strong>JSON</strong> contenant les <strong>identifiants</strong>, les <strong>noms</strong>, les <strong>positions</strong> des archi-monstres, ainsi que leurs <strong>dates de détection</strong>.</p><p>La date est aux format <strong>UnixTime</strong>.</p> |
| **`Vide`**      | Si vous n'avez pas d'abonnement archi-monstre sur le serveur choisi.                                                                                                                                                                                                                      |

{% hint style="danger" %}
L'utilisation de cette **API** ainsi que l'accès aux **notifications dans le Discord** n'est possible que pour les membre ayant un abonnement du type **Archi-Monstres** sur le **serveur concerné**.
{% endhint %}

## Exemple :

On souhaite extraire la liste des archi-monstres détectés sur **`Merkator`** pendant les **`90`** dernières minutes.

{% hint style="info" %}
[https://www.ankabot.dev/API/ArchiMonsters.php?key=**5a51b7ea3d8077f80deeb8398307192d**\&serveur=**Merkator**\&last=**90**](https://www.ankabot.dev/API/ArchiMonsters.php?key=5a51b7ea3d8077f80deeb8398307192d\&serveur=Merkator\&last=90)
{% endhint %}

### **Réponse JSON :**

```javascript
{
    "2579": {
        "name": "Nerdeubeu le Flagellant",
        "position": "[-56,17]",
        "mapid": 63963395,
        "time": 1623760242
    },
    "2355": {
        "name": "Tofuldebeu l'Explosif",
        "position": "[10,5]",
        "mapid": 88085266,
        "time": 1623760035
    },
    "2332": {
        "name": "Larchimaide la Poussée",
        "position": "[9,-2]",
        "mapid": 68420613,
        "time": 1623759616
    },
    "2335": {
        "name": "Minsinistre l'Elu",
        "position": "[11,20]",
        "mapid": 88085763,
        "time": 1623758678
    },
    "2400": {
        "name": "Bi le Partageur",
        "position": "[0,-44]",
        "mapid": 88085755,
        "time": 1623758173
    },
    "2413": {
        "name": "Robocoop l'Échangé",
        "position": "[-14,-22]",
        "mapid": 88085764,
        "time": 1623757789
    }
}
```