Sviluppatori

API v2

Un solo endpoint, solo POST, risposta JSON. Stesso catalogo e stessi prezzi del pannello, dal tuo sito, bot o foglio di calcolo.

Quattro cose da sapere per prime

01

La tua chiave è il tuo portafoglio

Generala sulla pagina dell'account. Autorizza la spesa, quindi il suo posto è nella configurazione del server. Ruotala se è mai passata per un browser, una chat o uno screenshot.

02

I limiti sono per servizio

Le quantità minima e massima si impostano singolarmente: un servizio parte da 10 unità, il successivo da 500 000. Leggile da services e convalidale prima di inviare un ordine.

03

Gli ordini spendono il saldo

Non c'è un passaggio di fattura. add riesce solo finché il saldo copre l'ordine, quindi interroga balance e ferma la coda prima che arrivi a zero.

04

Hai già un pannello? Nessun codice

PerfectPanel e la maggior parte degli script di pannello leggono questo formato in modo nativo. Nel tuo admin vai su Providers → Add provider e incolla l'indirizzo del sitohttps://autosmo.com/, solo quello, non l'endpoint. Aggiungi la tua chiave, sincronizza il catalogo, imposta il tuo margine.

Una richiesta, dall'inizio alla fine

esempio svolto
effettua un ordine e rileggilo
curl -X POST https://autosmo.com/api/v2 \\
  -d key=YOUR_KEY \\
  -d action=add \\
  -d service=6758 \\
  -d link=https://instagram.com/yourprofile \\
  -d quantity=100

{"order": 8231455}

curl -X POST https://autosmo.com/api/v2 -d key=YOUR_KEY -d action=status -d order=8231455

{"charge": "0.016", "start_count": "2841", "status": "Completed",
 "remains": "0", "currency": "USD"}

Il servizio 6758 è un id reale del catalogo. Le quantità sotto il minimo di un servizio vengono rifiutate, non arrotondate per eccesso.

Passalo a un agente

copia & incolla

Incolla questo in ChatGPT, Claude o Cursor, indica il tuo linguaggio e ottieni un client funzionante. Porta con sé l'elenco completo delle chiamate più il comportamento in cui è facile sbagliare.

prompt di integrazione
Build me a client for the AutoSMO SMM API (v2), in a language I will name.

ENDPOINT
POST https://autosmo.com/api/v2 — form-encoded body, JSON response, no other verbs.
Authentication is the field `key`, sent with every call. Server-side only.

CALLS
action=services -> array of { service, name, type, category, rate (per 1000),
                              min, max, refill:bool, cancel:bool }
action=add      params: service, link, quantity [, runs, interval]  -> { "order": id }
                custom comments: service, link, comments
action=status   params: order | orders (comma separated, max 100)
                -> { charge, start_count, status, remains, currency }
action=refill   params: order | orders (max 100)   -> { "refill": id }
action=refill_status  params: refill | refills     -> { "status": ... }
action=cancel   params: orders (max 100)
action=balance                                      -> { balance, currency }

BEHAVIOUR THAT COSTS MONEY IF IGNORED
- A timed-out `add` is not a failed `add`. The order may exist and be paid for.
  Surface it for a human; do not resend it on a timer.
- Quantity outside a service's own min/max is refused outright, so read those
  bounds from the catalogue and check before sending.
- Status is polled with `orders` and up to 100 ids at once. Per-order polling
  works in testing and dies in production.
- A 200 response can still contain per-entry errors when several ids were
  requested. Walk the entries; do not trust the envelope.
- "Partial" is a delivery that stopped early: `remains` is the shortfall and
  `charge` is the real cost. Pass that difference back to your buyer.
- Refill and cancel exist only where the catalogue flags say so.

WHAT I EXPECT FROM YOU
- One function per call, with the response parsed into typed structures.
- My order reference stored next to the id this API returns.
- Two background jobs: refresh the catalogue, and follow orders still open.
- A rehearsal switch that logs calls without sending them, and a single
  end-to-end test using the cheapest service in the catalogue.

Checklist prima di andare in produzione

La chiave non è in nulla che un cliente possa aprire

Non nel JavaScript front-end, non in un bundle mobile, non in un repository pubblico. Chiunque la possieda può effettuare ordini a carico del tuo saldo.

I timeout vengono messi in coda per un umano, non riprovati

Poiché add non ha una chiave di idempotenza, un tentativo automatico è il modo in cui un ordine di un cliente diventa due ordini pagati.

La tua copia del catalogo si aggiorna secondo una pianificazione

Tariffe, limiti e disponibilità cambiano quando i fornitori cambiano i loro. Una copia locale obsoleta vende a prezzi che non hai più.

Gli ordini parziali arrivano parziali al tuo cliente

Mappa remains nella tua logica di rimborso. Segnare una consegna parziale come completata è il modo più rapido per guadagnarti un chargeback.

Hai seguito un ordine reale dall'inizio alla fine

Effettua l'ordine più piccolo che il catalogo consente, interrogalo fino al completamento e conferma che la tua parte corrisponda a charge al centesimo prima di spostare il traffico.

Riferimento completo, generato dal pannello

API

Metodo HTTP POST
URL dell'API https://autosmo.com/api/v2
Formato della risposta JSON

Service list

Parameters Description
key Your API key
action services

Esempio di risposta

[
    {
        "service": 1,
        "name": "Followers",
        "type": "Default",
        "category": "First Category",
        "rate": "0.90",
        "min": "50",
        "max": "10000",
        "refill": true,
        "cancel": true
    },
    {
        "service": 2,
        "name": "Comments",
        "type": "Custom Comments",
        "category": "Second Category",
        "rate": "8",
        "min": "10",
        "max": "1500",
        "refill": false,
        "cancel": true
    }
]

Add order

Esempio di risposta

{
    "order": 23501
}

Order status

Parameters Description
key Your API key
action status
order Order ID

Esempio di risposta

{
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "USD"
}

Multiple orders status

Parameters Description
key Your API key
action status
orders Order IDs (separated by a comma, up to 100 IDs)

Esempio di risposta

{
    "1": {
        "charge": "0.27819",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157",
        "currency": "USD"
    },
    "10": {
        "error": "Incorrect order ID"
    },
    "100": {
        "charge": "1.44219",
        "start_count": "234",
        "status": "In progress",
        "remains": "10",
        "currency": "USD"
    }
}

Create refill

Parameters Description
key Your API key
action refill
order Order ID

Esempio di risposta

{
    "refill": "1"
}

Create multiple refill

Parameters Description
key Your API key
action refill
orders Order IDs (separated by a comma, up to 100 IDs)

Esempio di risposta

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

Get refill status

Parameters Description
key Your API key
action refill_status
refill Refill ID

Esempio di risposta

{
    "status": "Completed"
}

Get multiple refill status

Parameters Description
key Your API key
action refill_status
refills Refill IDs (separated by a comma, up to 100 IDs)

Esempio di risposta

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

Create cancel

Parameters Description
key Your API key
action cancel
orders Order IDs (separated by a comma, up to 100 IDs)

Esempio di risposta

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

User balance

Parameters Description
key Your API key
action balance

Esempio di risposta

{
    "balance": "100.84292",
    "currency": "USD"
}
Esempio di codice PHP