# Configuration

## Récupérer la clé 

Vous pouvez récupérer votre clé secrète depuis les paramètres de votre Spot : 

* Allez dans l'onglet `Accès API` 
* Copiez votre clé secrète !

{% hint style="warning" %}
Cette fonctionnalité est réservée à certains plans payants MeltingSpot. Si vous n'avez pas accès à cet onglet, [contactez-nous.](mailto:support@meltingspot.Io)
{% endhint %}

## Implémentation

Pour vous connecter à l'API : 

* Configurez votre header en ajoutant un élément "Authorisation" qui doit contenir **votre clé secrète.**
* Configurez l'URL en utilisant l'URL d'appel suivante :  [<mark style="background-color:yellow;">https://openapi.meltingspot.io</mark>](https://openapi.meltingspot.io/)
* Sélectionnez une method.
* Vous pouvez également **ajouter des filtres** (comme expliqué [ici](#filtres)) et remplir le body si nécessaire !

Vous pouvez retrouver la liste complète des endpoints à votre disposition [ici](https://help-api.meltingspot.io/) 🤓

{% hint style="info" %}
Attention, la limite des requêtes API est de :&#x20;

* **100 requêtes / 10 sec**
* **50000 requêtes / jour**
  {% endhint %}

### **Filtres**

Pour les filtres, nous utilisons la méthode LHS Bracket. Elle permet, lorsque vous souhaitez récupérer une liste de contenus ou d'éléments, de filtrer cette liste. Les filtres s'ajoutent à la fin de l'URL ou dans les `Query parameters`.&#x20;

Par exemple : cet URL permet de lister les membres dont l'email est "<john.doe@gmail.com>".

```
https://openapi.meltingspot.io/v1/spotMembers?email[in]=john.doe@gmail.com
```

Pour filtrer vos données, vous avez à disposition un certain nombre d'opérateurs :&#x20;

<table><thead><tr><th width="135">Opérateur</th><th>Signification</th></tr></thead><tbody><tr><td><strong>eq</strong></td><td>égal à</td></tr><tr><td><strong>neq</strong></td><td>non égal à</td></tr><tr><td><strong>gt</strong></td><td>supérieur à</td></tr><tr><td><strong>gte</strong></td><td>supérieur ou égal à</td></tr><tr><td><strong>lt</strong></td><td>inférieur à</td></tr><tr><td><strong>lte</strong></td><td>inférieur ou égal à</td></tr><tr><td><strong>in</strong></td><td>inclus dans liste spécifique (chaque élément est séparé par une virgule)</td></tr><tr><td><strong>notin</strong></td><td>non inclus dans liste spécifique (chaque élément est séparé par une virgule)</td></tr></tbody></table>

{% hint style="info" %}
Attention, si vous utilisez un filtre de date, vous devez utiliser le format timestamp dans vos requêtes !&#x20;
{% endhint %}