# API Archi-Monstre

{% 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="../rejoindre-notre-discord" %}
[rejoindre-notre-discord](https://doc.ankabot.dev/rejoindre-notre-discord)
{% endcontent-ref %}

{% content-ref url="../abonnement" %}
[abonnement](https://doc.ankabot.dev/abonnement)
{% 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
    }
}
```


---

# Agent Instructions: 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:

```
GET https://doc.ankabot.dev/autres/api-archi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.