Przejdź do treści
Zaloguj sięZałóż konto

API panelu SMM: usługi, zamówienia, status i saldo

API SMMHO działa w formacie API v2, wspólnym dla paneli SMM. Wyślij POST na jeden adres, wybierz zadanie wartością action i odbierz odpowiedź w JSON.

Podstawy API

Endpoint
POST https://smmho.com/api/v2
Format żądania
application/x-www-form-urlencoded lub application/json
Uwierzytelnianie
Twój klucz API w polu key. Utworzysz go na stronie konta po zalogowaniu
Odpowiedź
JSON. Nieudane żądania zwracają przyczynę w polu error
Limit zapytań
300 żądań na minutę na klucz
Utwórz klucz APIKlucz API utworzysz na stronie konta po zalogowaniu.
curl https://smmho.com/api/v2 \  -d "key=YOUR_API_KEY" \  -d "action=add" -d "service=9340" \  -d "link=https://instagram.com/me" \  -d "quantity=1000"
// { "order": "TT5M-CA9L" }

Akcje API panelu SMM

action=servicesLista usług

Zwraca wszystkie usługi z ID, nazwą, kategorią, ceną za 1000, minimalną i maksymalną ilością oraz informacją, czy mają uzupełnienie.

Parametry
NazwaOpis
keyKlucz API
actionservices

Przykładowa odpowiedź

[
  {
    "service": 9340,
    "name": "Instagram Followers, 30-day refill",
    "type": "Default",
    "category": "Instagram Followers",
    "rate": "2.2470",
    "min": 50,
    "max": 75000,
    "refill": true,
    "cancel": true
  }
]

action=addNowe zamówienie

Składa zamówienie z ID usługi, linkiem i ilością. Opłata jest pobierana z salda, a w odpowiedzi dostajesz kod zamówienia.

Parametry
NazwaOpis
keyKlucz API
actionadd
serviceID usługi
linkLink do konta lub posta
quantityIlość (w granicach min i maks usługi)

Przykładowa odpowiedź

{
  "order": "TT5M-CA9L"
}

action=statusStatus zamówienia

Zwraca opłatę, liczbę początkową, status i pozostałą ilość dla jednego kodu zamówienia (order) lub do 100 kodów oddzielonych przecinkami (orders).

Parametry
NazwaOpis
keyKlucz API
actionstatus
orderJeden kod zamówienia
ordersKilka kodów zamówień (oddzielone przecinkami, do 100)

Przykładowa odpowiedź

{
  "charge": "2.2470",
  "start_count": 0,
  "status": "Pending",
  "remains": 1000,
  "currency": "USD"
}

action=balanceSaldo

Zwraca aktualne saldo i walutę.

Parametry
NazwaOpis
keyKlucz API
actionbalance

Przykładowa odpowiedź

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

action=cancelAnulowanie zamówień

Anuluje oczekujące zamówienia. Opłata wraca na saldo.

Parametry
NazwaOpis
keyKlucz API
actioncancel
ordersKody zamówień (oddzielone przecinkami, do 100)

Przykładowa odpowiedź

[
  {
    "order": "TT5M-CA9L",
    "cancel": 1
  }
]

action=refillProśba o uzupełnienie

Zgłasza prośbę o uzupełnienie dla zrealizowanego lub częściowego zamówienia, które mieści się w okresie uzupełnienia. W odpowiedzi dostajesz kod zgłoszenia.

Parametry
NazwaOpis
keyKlucz API
actionrefill
orderKod zamówienia

Przykładowa odpowiedź

{
  "refill": "RK7QM-2XWD"
}

Wartości statusu zamówienia

Pending
Jeszcze nie ruszyło, można anulować
In progress
W trakcie dostarczania
Completed
W pełni dostarczone
Partial
Dostarczone częściowo. Niedostarczona część wraca na saldo
Canceled
Anulowane. Opłata wraca na saldo

Błędy API

Invalid API key
Klucz jest błędny albo został zastąpiony nowym
Invalid service
Nie ma usługi o takim ID
Invalid link
To nie jest publiczny adres zaczynający się od https://
Quantity out of range
Ilość jest poza min i maks usługi
Not enough funds on balance
Saldo jest za niskie
Too many requests
Osiągnięto limit zapytań. Wyślij ponownie za chwilę
Refill already requested
Prośba o uzupełnienie dla tego zamówienia jest już otwarta
Refill is not available for this order
Usługa nie ma uzupełnienia albo okres uzupełnienia minął