Documentazione API

Followir offre una semplice API HTTP che segue il comune formato SMM Panel API v2, quindi la maggior parte dei pannelli reseller e degli script funziona senza modifiche. Tutte le risposte sono in JSON.

Per iniziare

Crea un account e aggiungi dei fondi.
Apri la pagina API nel tuo account e genera la tua chiave API. Tienila privata.
Facoltativo: aggiungi gli indirizzi IP autorizzati a usare la tua chiave (lascia vuoto per consentire qualsiasi IP).

Endpoint

URL	`https://followir.com/api/v2`
Metodo	POST (funziona anche GET)
Formato	Parametri di form in ingresso, JSON in uscita
Obbligatori in ogni chiamata	`key` (la tua chiave API) e `action`

Azioni

action	Parametri	Cosa fa
`services`	key	Elenca tutti i servizi disponibili con prezzi e limiti
`add`	key, service, link, quantity (runs, interval per il drip-feed)	Effettua un nuovo ordine
`status`	key, order oppure orders (separati da virgola)	Stato dell'ordine, uno o più
`cancel`	key, order oppure orders (separati da virgola)	Annulla gli ordini sui servizi che lo consentono
`refill`	key, order oppure orders (separati da virgola)	Richiedi un refill sugli ordini idonei
`refill_status`	key, refill	Stato di una richiesta di refill
`balance`	key	Il tuo saldo attuale e la valuta

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 è il prezzo ogni 1000. refill e cancel indicano se il servizio li supporta.

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 }

Per i servizi drip-feed puoi inviare anche runs (almeno 2) e interval (minuti, da 1 a 1440). Vengono ignorati sugli altri servizi.

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"
}

Più ordini contemporaneamente: invia orders=850758,850759. La risposta è un oggetto indicizzato per numero d'ordine. Valori possibili di 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" }

Alcuni annullamenti attendono una conferma e in tal caso la risposta mostra "status": "Pending". Con più ordini ottieni un elenco di elementi { "order": ..., "cancel": ... }.

refill and 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" }

Errori

Quando qualcosa va storto, la risposta contiene un campo error:

{ "error": "Not enough funds" }

Messaggio	Significato
`API key is required`	Manca il parametro `key`
`Action is required` / `Incorrect action`	`action` mancante o sconosciuta
`Invalid API key`	La chiave è errata, disattivata, oppure il tuo IP non è nella whitelist
`Incorrect service ID` / `Service not found`	Il numero del servizio non esiste o è disattivato
`Link is required` / `Incorrect quantity`	Link mancante, oppure la quantità non è un numero valido
`Quantity must be between ...`	Fuori dal minimo e dal massimo del servizio
`Not enough funds`	Il tuo saldo è troppo basso per questo ordine
`Order not found`	L'ordine non esiste nel tuo account
`Cancel is not available for this service`	Questo servizio non può essere annullato

Esempi di codice

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())

Da sapere

I numeri d'ordine sono gli stessi che vedi nella pagina dei tuoi ordini.
Effettuare molti ordini contemporaneamente per lo stesso link può essere rifiutato finché il primo non termina.
Ogni chiamata viene registrata sul tuo account. Se pensi che la tua chiave sia trapelata, rigenerala dalla pagina API.
Hai bisogno di aiuto con l'integrazione? Apri un ticket nella pagina di assistenza.