Documentation de l'API

Followir propose une API HTTP simple qui suit le format courant de l'SMM Panel API v2, de sorte que la plupart des panels de revendeurs et des scripts fonctionnent avec elle tels quels. Toutes les réponses sont au format JSON.

Pour commencer

Créez un compte et ajoutez des fonds.
Ouvrez la page API de votre compte et générez votre clé API. Gardez-la confidentielle.
Facultatif : ajoutez les adresses IP autorisées à utiliser votre clé (laissez vide pour autoriser n'importe quelle IP).

Point d'accès

URL	`https://followir.com/api/v2`
Méthode	POST (GET fonctionne aussi)
Format	Paramètres de formulaire en entrée, JSON en sortie
Obligatoire dans chaque appel	`key` (votre clé API) et `action`

Actions

action	Paramètres	Fonction
`services`	key	Liste tous les services disponibles avec leurs prix et leurs limites
`add`	key, service, link, quantity (runs, interval pour le Drip-Feed)	Passe une nouvelle commande
`status`	key, order ou orders (séparés par des virgules)	Statut d'une ou de plusieurs commandes
`cancel`	key, order ou orders (séparés par des virgules)	Annule les commandes des services qui le permettent
`refill`	key, order ou orders (séparés par des virgules)	Demande un refill sur les commandes éligibles
`refill_status`	key, refill	Statut d'une demande de refill
`balance`	key	Votre solde actuel et la devise

services

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=services"

[
  {
    "service": "1",
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.9000",
    "min": "100",
    "max": "100000",
    "refill": true,
    "cancel": false
  }
]

rate est le prix pour 1 000. refill et cancel indiquent si le service les prend en charge.

add

curl -X POST "https://followir.com/api/v2" \
  -d "key=YOUR_API_KEY" -d "action=add" \
  -d "service=1" -d "link=https://instagram.com/username" -d "quantity=1000"

{ "order": 850758 }

Pour les services Drip-Feed, vous pouvez aussi envoyer runs (au moins 2) et interval (minutes, de 1 à 1440). Ils sont ignorés pour les autres services.

status

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=status" -d "order=850758"

{
  "charge": "0.9000",
  "start_count": "3572",
  "status": "In progress",
  "remains": "400",
  "currency": "USD"
}

Plusieurs commandes à la fois : envoyez orders=850758,850759. La réponse est un objet indexé par numéro de commande. Valeurs possibles de status : Pending, In progress, Completed, Partial, Canceled, Refunded.

cancel

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=cancel" -d "order=850758"

{ "status": "Success" }

Certaines annulations attendent une confirmation, et la réponse affiche alors "status": "Pending". Avec plusieurs commandes, vous obtenez une liste d'éléments { "order": ..., "cancel": ... }.

refill et refill_status

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=refill" -d "order=850758"
{ "refill": "12" }

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=refill_status" -d "refill=12"
{ "refill": "12", "status": "Pending" }

balance

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=balance"

{ "balance": "25.50", "currency": "USD" }

Erreurs

Quand un problème survient, la réponse contient un champ error :

{ "error": "Not enough funds" }

Message	Signification
`API key is required`	Le paramètre `key` est manquant
`Action is required` / `Incorrect action`	`action` manquante ou inconnue
`Invalid API key`	La clé est incorrecte ou désactivée, ou votre IP ne figure pas sur la liste blanche
`Incorrect service ID` / `Service not found`	Le numéro de service n'existe pas ou est désactivé
`Link is required` / `Incorrect quantity`	Lien manquant, ou la quantité n'est pas un nombre valide
`Quantity must be between ...`	En dehors du minimum et du maximum du service
`Not enough funds`	Votre solde est trop faible pour cette commande
`Order not found`	La commande n'existe pas sur votre compte
`Cancel is not available for this service`	Ce service ne peut pas être annulé

Exemples de code

PHP

$ch = curl_init("https://followir.com/api/v2");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'key'    => 'YOUR_API_KEY',
    'action' => 'add',
    'service'  => 1,
    'link'     => 'https://instagram.com/username',
    'quantity' => 1000,
]));
$response = json_decode(curl_exec($ch), true);
print_r($response);

Python

import requests

r = requests.post("https://followir.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "status",
    "order": 850758,
})
print(r.json())

Bon à savoir

Les numéros de commande sont les mêmes que ceux affichés sur votre page Commandes.
Passer plusieurs commandes simultanées pour le même lien peut être refusé tant que la première n'est pas terminée.
Chaque appel est enregistré sur votre compte. Si vous pensez que votre clé a fuité, régénérez-la depuis la page API.
Besoin d'aide pour l'intégration ? Ouvrez un ticket sur la page d'assistance.