Documentazione API | Wizard4SocialMedia.com | Negozio di servizi per i social media

Dettagli API

L'API di Wizard4SocialMedia ti consente di interagire con il nostro sito semplicemente inviando una richiesta al nostro server. Questo servizio è offerto gratuitamente.

Puoi automatizzare l'inserimento degli ordini, monitorare lo stato di consegna, tenere traccia del tuo saldo attuale e accedere a tutte le informazioni sui nostri servizi in modo programmatico. Perfetto per rivenditori che gestiscono i propri pannelli, agenzie che gestiscono più clienti, o sviluppatori che creano soluzioni personalizzate.

Metodo HTTP	POST
URL API	https://wizard4socialmedia.com/api/v2
Chiave API	Ottieni una chiave API nella tua pagina Account
Formato di risposta	JSON
Esempio di codice PHP	https://wizard4socialmedia.com/example.txt

Aggiungi ordine

Usa questo metodo per effettuare un nuovo ordine per qualsiasi servizio attivo.

Tipo di servizio:

Parametri	Descrizioni
api_token	Il tuo token API
action	Nome del metodo
service	ID del servizio
link	Link alla pagina
quantity	Quantità necessaria

Parametri	Descrizioni
api_token	Il tuo token API
action	Nome del metodo
service	ID del servizio
link	Link alla pagina
quantity	Quantità da consegnare in ogni esecuzione.
runs	Numero di esecuzioni. Numero intero, almeno 2.
interval	Minuti tra le esecuzioni. Numero intero da 5 a 1440, in multipli di 5.

Solo i servizi con la funzione Drip Feed accettano runs e interval. Esecuzioni x quantità non può superare il massimo del servizio. L’importo totale (prezzo x quantità x esecuzioni) viene addebitato quando l’ordine viene effettuato, e la prima esecuzione parte subito. Ogni esecuzione successiva parte quando la precedente è terminata e l’intervallo è trascorso. L’ID ordine restituito si usa con status e cancel come per qualsiasi altro ordine.

Parametri	Descrizioni
api_token	Il tuo token API
action	Nome del metodo
service	ID del servizio
username	Username or profile link to be serviced.
min	Minimum quantity per post.
max	Maximum quantity per post.
posts	Number of new (future) posts to be serviced. Required, at least 1.
old_posts	Optional. Number of existing posts to be serviced right away.
delay	Optional. Delay in minutes after a new post. Possible values: 0, 5, 10, 15, 20, 30, 40, 50, 60, 90, 120, 150, 180, 210, 240, 270, 300, 360, 420, 480, 540, 600.
expiry	Optional. Expiry date, format d/m/Y (for example 31/12/2026). Must be in the future.

Nothing is charged when the subscription is created. Each delivered post is charged at the service rate when its order is created.

Parametri	Descrizioni
api_token	Il tuo token API
action	Nome del metodo
service	ID del servizio
link	Link alla pagina
quantity	Quantità necessaria
custom_data	Facoltativo - necessario solo per commenti personalizzati, menzioni e altri servizi correlati. Elenco dei commenti separati da \r\n o \n
comment_mode	Facoltativo - necessario solo se il tuo pannello supporta i commenti con paragrafi (più righe all’interno di un singolo commento). Lascialo vuoto se i tuoi commenti sono composti da una sola riga e invia `custom_data` come descritto sopra. Se il tuo pannello supporta i commenti con paragrafi, invia `comment_mode=paragraphs` e invia `custom_data` come array JSON con un elemento per ogni commento, ad esempio: `["Primo commento\n\nSecondo paragrafo","Un altro commento"]` Questo funziona solo per i servizi in cui `paragraphs` è impostato su `true` nell’elenco dei servizi.

Risposta di successo:

{
  "order":"23501"
}

Stato ordine

Usa questo metodo per ottenere lo stato di uno qualsiasi dei tuoi ordini.

Quando controlli lo stato dell'ordine, ti chiediamo di non farlo in modo eccessivo, altrimenti potremmo dover limitare le tue richieste.

Parametri	Descrizioni
api_token	Il tuo token API
action	Nome del metodo
order	ID dell'ordine

Ordini Drip Feed: usa l’ID ordine restituito da add. status descrive l’intero ordine. Mentre è in esecuzione restituisce In Progress. start_counter è il valore all’inizio della prima esecuzione, e remains è la quantità non ancora consegnata (esecuzioni non avviate più tutto ciò che resta nelle esecuzioni già avviate). Quando l’ordine termina restituisce Completed, Partial o Cancelled, e remains è la quantità finale non consegnata.

Annullamento: un ordine con stato Cancelling non è ancora definitivo. Continua a controllare il suo stato finché non passa a Cancelled o Partial, e rimborsa il tuo cliente solo in base a questa risposta finale.

Risposta di successo:

{
  "status": "Completed",
  "start_counter": "600",
  "remains": "600",
  "charge": "0.25845",
  "currency": "USD"
}

Drip feed order:

{
  "status": "Completed",
  "start_counter": "600",
  "remains": "0",
  "charge": "2.40000",
  "currency": "USD",
  "runs": "3",
  "orders": ["14286", "14287", "14288"]
}

Auto subscription order. Each ID in "orders" and "old_orders" is a normal order, so you can query its status individually. "posts" and "old_posts" are the numbers delivered so far, and "expired" is true if the subscription ended by reaching its expiry date:

{
  "status": "Inprogress",
  "expiry": "2027-12-31",
  "expired": false,
  "posts": 1,
  "old_posts": 1,
  "orders": ["14255"],
  "old_orders": ["14256"]
}

Annulla ordine

Un ordine può essere annullato automaticamente tramite API se il "Conteggio iniziale" è ancora vuoto (l'annullamento e il rimborso richiedono 10-20 minuti). Una volta aggiornato il "Conteggio iniziale", il lavoro sull'ordine è iniziato e non può più essere annullato automaticamente tramite API.

Per gli ordini già avviati, potremmo comunque riuscire ad annullarli manualmente, ma dovrai richiedere l'annullamento aprendo un ticket.

Parametri	Descrizioni
api_token	Il tuo token API
action	Nome del metodo
order	ID ordine, separati da virgola, fino a 100 ID

Ordini Drip Feed: una richiesta di annullamento viene sempre accettata. Se nessuna esecuzione è attiva, l’ordine viene finalizzato subito e le esecuzioni mai avviate vengono rimborsate. Se un’esecuzione è attiva, l’ordine mostra Cancelling finché quell’esecuzione non termina, e poi si conclude come Cancelled (nulla è stato consegnato) o Partial. Usa status per leggere il remains finale.

An auto subscription can be cancelled too. No new orders are created, and it shows “Cancelling” until its active orders finish. It ends as Cancelled if nothing was delivered, otherwise as Partial.

Esempio di risposta:

[
  {
    "order": 721,
    "cancel": 1,
    "message": "We are now attempting to cancel your order..."
  },
  {
    "order": 722,
    "errors": ["This order cannot be cancelled because its current status is COMPLETED."]
  }
]

Crea una richiesta di ricarica

Richiedi una ricarica per un singolo ordine o per più ordini contemporaneamente. Solo i servizi con "refill": true supportano questa funzione e le ricariche sono disponibili per un periodo limitato dopo il completamento di un ordine.

Parametri	Descrizioni
api_token	Il tuo token API
action	Nome del metodo
order	ID dell'ordine
orders	ID ordine, separati da virgola, fino a 100 ID

Esempio di risposta:

{
  "refill": "1"
}

[
  {
    "order": 1,
    "refill": 1
  },
  {
    "order": 2,
    "refill": {
      "error": "Incorrect order ID"
    }
  }
]

Stato della ricarica

Controlla lo stato di una o più ricariche contemporaneamente. Statuses: Pending, In progress, Completed, Rejected.

Parametri	Descrizioni
api_token	Il tuo token API
action	Nome del metodo
refill	ID della ricarica
refills	ID delle ricariche (separati da virgole, fino a 100 ID)

Esempio di risposta:

{
  "status": "Completed"
}

[
  {
    "refill": 1,
    "status": "Completed"
  },
  {
    "refill": 2,
    "status": {
      "error": "Refill not found"
    }
  }
]

Elenco servizi

Questo restituirà tutti i servizi attivi con i relativi prezzi e parametri disponibili per il tuo account. Conterrà tutte le informazioni necessarie per impostare automaticamente o determinare i prezzi.

For subscription services, min and max are the limits for the quantity per post.

Parametri	Descrizioni
api_token	Il tuo token API
action	Nome del metodo

Esempio di risposta:

[
  {
      "id": 101,
      "service_id": 1,
      "name": "Real & Active Followers - Best Server",
      "rate": "250.00",
      "min": "100",
      "max": "100000",
      "service": "Instagram Followers",
      "type": "default",
      "refill": true,
      "cancel": true,
      "dripfeed": false,
      "subscription": false,
      "paragraphs": false,
      "desc": "0-3 Hours Start | Full Link | 20 Days Refill\r\nLink Format:\r\nhttps://www.instagram.com/official_social_sale/"
  },
  {
      "id": 107,
      "service_id": 1,
      "name": "Indian Mixed Followers",
      "rate": "150.00",
      "min": "200",
      "max": "10000",
      "service": "Instagram Followers",
      "type": "default",
      "refill": false,
      "cancel": false,
      "dripfeed": true,
      "subscription": false,
      "paragraphs": false,
      "desc": "0-12 Hours Start | Full Link |\r\nLink Format:\r\nhttps://www.instagram.com/official_social_sale/"
  },
  {
      "id": 30067,
      "service_id": 1,
      "name": "Instagram Followers - Worldwide",
      "rate": "103.00",
      "min": "100",
      "max": "10000",
      "service": "Instagram Followers",
      "type": "default",
      "refill": false,
      "cancel": true,
      "dripfeed": false,
      "subscription": false,
      "paragraphs": false,
      "desc": "10k/day\r\nMax - 55k\r\n8 Hours Start"

  },
  {
      "id": 85,
      "service_id": 12,
      "name": "Facebook Auto Likes",
      "rate": "35.00",
      "min": "50",
      "max": "10000",
      "service": "Auto Subscription",
      "type": "default",
      "refill": false,
      "cancel": true,
      "dripfeed": false,
      "subscription": true,
      "paragraphs": false,
      "desc": "Likes on every new post\r\nUse the subscription parameters to order"
  }
]

Saldo attuale

Utilizzato per ottenere l'importo del saldo disponibile sul tuo account.

Parametri	Descrizioni
api_token	Il tuo token API
action	Nome del metodo

Esempio di risposta:

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