Ombi la salio ndiyo njia ya haraka zaidi ya kuthibitisha ufunguo wako, umbizo la ombi, na kwamba muunganisho huo unasafiri kwenda na kurudi kabla ya kuanza kuagiza.
Tuma ufunguo wa API wa akaunti yako ama katika Uidhinishaji: Mbeba YOUR_API_KEY au kama sehemu ya ombi la ufunguo. Chagua njia moja; sehemu ya ufunguo hufanya kazi na paneli za kawaida za wauzaji. Weka funguo katika vigeu vya mazingira vya upande wa seva na uzizungushe kutoka Akaunti.
Vitendo vyote hutumia POST https://smm.africa/api/v3. Viungo vinavyoungwa mkono: programu/json, programu/x-www-form-urlencoded, na data ya sehemu nyingi/fomu yenye sehemu za maandishi pekee. Majibu ni JSON. Sehemu ya kitendo huchagua operesheni.
Kwa nini malipo ya mteja wangu yametenganishwa na pochi yangu ya SMM.Africa?
Mteja wako hulipa biashara yako chini ya mpangilio wako mwenyewe. Mkoba wako wa SMM.Africa hulipia maagizo unayotuma hapa. Kukusanya malipo ya mteja hakulipii pochi hiyo kiotomatiki, na urejeshaji wa pochi haumrudishii mteja wako kiotomatiki. Sawazisha rekodi hizi mbili kando, ikijumuisha ada na marejesho yoyote ya mteja yaliyoidhinishwa.
Fungua jibu hiliJe, niwekeje agizo langu la kwanza la API ya muuzaji?
Anza na uthibitishaji wa API na mifano ya salio, kisha kagua huduma, umbizo lengwa, vikomo na bei. Tumia lengo unalodhibiti na kiasi ndani ya mipaka iliyotajwa. Hatua ya kuongeza hutumia salio la mkoba. Hifadhi kitambulisho cha agizo lililorejeshwa na uangalie hali yake. Soma hati za sasa za API kabla ya kuchagua mkakati wa kujaribu tena.
Fungua jibu hiliJe, nitume agizo lingine la API ikiwa ombi la kwanza limeisha?
Kwanza angalia kama ombi asili liliunda agizo. Muda wa kuisha unaweza kuacha matokeo bila uhakika hata wakati uchakataji umefaulu. Hifadhi rejeleo la ombi na kitambulisho chochote cha agizo, na utumie utaratibu wa utambulisho ulioandikwa unapotumika. Usitoe ombi jipya lililolipwa kwa sababu tu jibu la kwanza halikuwepo; wasiliana na usaidizi ikiwa matokeo yatasalia kuwa wazi.
Kitufe chako cha API, kilichotumiwa kuthibitisha ombi. Inahitajika tu wakati Uidhinishaji: Mtoa huduma hayupo.
action
string
Ndiyo
add Tumia thamani halisi ya kitendo iliyoonyeshwa.
service
integer
Ndiyo
Kitambulisho cha huduma unayotaka kuagiza. Tumia Kitambulisho kutoka kwa jibu la sasa la huduma; aina yake huamua sehemu zilizo hapa chini.
link
string
Masharti
URL ya maudhui, wasifu, chapisho au maudhui lengwa. Inahitajika kwa aina ya huduma iliyochaguliwa; toa URL lengwa.
quantity
integer
Masharti
Kiasi unachotaka kuagiza. Lazima ikidhi kiwango cha chini na cha juu cha huduma iliyochaguliwa. Acha wakati aina yake haikubali wingi.
max_charge
number / decimal string
No
Optional maximum USD charge, including discounts, with up to six decimal places. PRICE_LIMIT_EXCEEDED (409) creates no order or debit. Changing a ceiling changes request intent. Gharama ya juu inayoruhusiwa kwa USD, yenye hadi nafasi sita za desimali.
idempotency_key
string
Inapendekezwa
Use one unique value per logical order. If the request times out without a response, retry with the same value so the order cannot be charged twice. Dumisha thamani ya kipekee kwa kila agizo la kimantiki; tumia tena tu kwa mzigo unaofanana wa kujaribu tena.
Sehemu kulingana na aina ya huduma
Chagua aina iliyorejeshwa na huduma; usitume sehemu tofauti ya aina. Thamani za orodha ni maandishi yaliyotenganishwa na mstari mpya, ikijumuisha katika JSON. API hupata kiasi kinachoweza kutozwa kwa maoni, orodha maalum, vifurushi, na usajili, kisha huangalia mipaka ya huduma.
Aina ya huduma
Sehemu zinazohitajika
Sehemu / vikwazo vya hiari
Default
link, quantity
URL lengwa ya kawaida na wingi ulioombwa.
Package
link
Hakuna wingi.
SEO
link, quantity, keywords
Weka neno moja muhimu kwenye kila mstari.
Custom Comments
link, comments
Maoni moja kwa kila mstari; idadi ya maoni ni wingi wa agizo.
Custom Comments Package
link, comments
Maoni moja kwa kila mstari; hakuna wingi.
Comment Replies
link, username, comments
jina la mtumiaji ndiye mmiliki wa maoni; weka jibu moja kwa kila mstari.
Comment Likes
link, username
jina la mtumiaji ndiye mmiliki wa maoni; hakuna wingi.
Mentions
link, quantity, usernames
Weka jina la mtumiaji moja kwa kila mstari.
Mentions with Hashtags
link, quantity, usernames, hashtags
Weka majina ya watumiaji na lebo za reli kwenye mistari tofauti.
Mentions Custom List
link, usernames
Weka jina la mtumiaji moja kwa kila mstari; hakuna wingi.
Mentions Hashtag
link, quantity, hashtags
Weka alama ya reli moja kwa kila mstari.
Mentions User Followers
link, quantity, username
jina la mtumiaji ni URL ya wasifu wa chanzo cha kukwarua.
Mentions Media Likers
link, quantity, media
media ndio chanzo cha URL cha midia kukwangua.
Poll
link, quantity, answer
jibu ni maandishi kamili ya chaguo la kura inayotarajiwa na mtoaji huduma.
Invites from Groups
link, quantity, groups
Weka kundi moja kwenye kila mstari.
Web Traffic
quantity, country, device, type_of_traffic
kifaa ni simu au eneo-kazi. type_of_trafiki ni 1 (inahitaji google_keyword), 2 (inahitaji referring_url), au 3.
Sehemu za hiari za uhusishaji
Kigezo
Aina
Inahitajika
Maelezo na vikwazo
goal_key
string
No
Kitufe cha hiari cha lengo kwa maelezo ya ukuaji wa kuongozwa. Metadata ya uainishaji wa hiari.
recommendation_tier
string
No
Kiwango cha pendekezo cha hiari. Metadata ya uainishaji wa hiari.
user_intent_label
string
No
Lebo ya hiari inayoelezea dhamira ya mtumiaji. Metadata ya uainishaji wa hiari.
source_flow
string
No
Kitambulisho cha hiari cha mtiririko uliounda mpangilio. Metadata ya uainishaji wa hiari.
Kitufe chako cha API, kilichotumiwa kuthibitisha ombi. Inahitajika tu wakati Uidhinishaji: Mtoa huduma hayupo.
action
string
Ndiyo
status Tumia thamani halisi ya kitendo iliyoonyeshwa.
order
integer / string
Ndiyo
Kitambulisho cha agizo la SMM Africa kilirudishwa kwa kuongeza. Hifadhi kitambulisho cha agizo kilichorejeshwa kwa kuongeza; usibadilishe kitambulisho cha agizo la mtoa huduma.
orders
array / string
Masharti
For bulk status, send 1–20 IDs as a JSON array or comma-separated form string instead of order. Inspect each item's http_status and retry_after. Tumia order au orders, kamwe si zote mbili. Kila kipengee cha kundi kina http_status yake.
Kitufe chako cha API, kilichotumiwa kuthibitisha ombi. Inahitajika tu wakati Uidhinishaji: Mtoa huduma hayupo.
action
string
Ndiyo
refill Tumia thamani halisi ya kitendo iliyoonyeshwa.
order
integer / string
Ndiyo
Kitambulisho cha agizo la SMM Africa kilirudishwa kwa kuongeza. Hifadhi kitambulisho cha agizo kilichorejeshwa kwa kuongeza; usibadilishe kitambulisho cha agizo la mtoa huduma.
Kitufe chako cha API, kilichotumiwa kuthibitisha ombi. Inahitajika tu wakati Uidhinishaji: Mtoa huduma hayupo.
action
string
Ndiyo
cancel Tumia thamani halisi ya kitendo iliyoonyeshwa.
order
integer / string
Ndiyo
Kitambulisho cha agizo la SMM Africa kilirudishwa kwa kuongeza. Hifadhi kitambulisho cha agizo kilichorejeshwa kwa kuongeza; usibadilishe kitambulisho cha agizo la mtoa huduma.
Angalia salio, pata huduma, chagua aina ya huduma, hifadhi kitambulisho cha operesheni, tuma agizo, hifadhi kitambulisho chake, kisha uliza hali. Bei ni USD; viwango ni kwa vipimo 1,000 au kwa kifurushi kulingana na aina ya huduma. Tumia vitambulisho kama maandishi bila kutafsiri muundo wake. Maandishi ya desimali na sehemu za fedha za nambari huhifadhi aina zake; gharama hutumia nafasi sita za desimali za USD.
Wateja wa Node.js na PHP 3.3 huhifadhi funguo za operesheni na majibu yaliyofaulu, hufuata Retry-After na husimamisha mabadiliko yasiyotatuliwa kabla ya dirisha la kurudia la saa 24 kuisha. Hifadhi hali kwa faragha, kwa kudumu na tofauti kwa kila akaunti. Jaribu kwanza katika mazingira ya ndani yasiyounganishwa na pochi au wasambazaji halisi.
node sandbox.mjs
# Endpoint: http://127.0.0.1:4013/api/v3
# Key: sandbox_test_key (never use a live key)
subscription_create
Unda usajili wenye kikomo bila kukata fedha. Tumia huduma ya URL ya chapisho, kiasi chanya cha nambari nzima, USD, spending_cap yenye hadi desimali sita, max_posts (1–10000), na ufunguo wa idempotency uliohifadhiwa.
Tuma URL ya chapisho lililogunduliwa. Huduma na kiasi hutoka kwenye usajili. max_charge ya hiari huweka kikomo cha chapisho hili kwa USD. URL sanifu inayorudiwa hurudisha agizo lake la awali, hata baada ya kughairi.
Soma mipangilio na hadi risiti 20 za machapisho. Tumia after=next_cursor kwa kurasa zinazofuata. Uliza vitambulisho vya maagizo ya risiti kwa hali ya kundi.
Sanidi mpokeaji mmoja wa HTTPS aliyehakikiwa kwa kila akaunti. Kipengele lazima kiwezeshwe kwenye mfumo uliowekwa. Tengeneza siri nasibu ya base64url yenye herufi 32–128. Hakiki X-SMM-Signature, kisha rudisha changamoto ya webhook.verify kama JSON. Usanidi mpya hubatilisha matukio ya zamani yanayosubiri.
Soma hadi utumaji 20, maudhui yake, majaribio, hali ya mwisho ya HTTP na muda wa jaribio linalofuata. Tumia after=next_cursor kwa kurasa zinazofuata. Historia huhifadhiwa siku 30.
Weka tena kwenye foleni tukio lililotumwa au lililoshindwa kwa toleo lilelile la mpokeaji. Kitambulisho cha tukio huhifadhiwa. Wapokeaji lazima waondoe marudio; kurudia hakurudii agizo wala mabadiliko ya pochi.
X-SMM-Signature contains t=UNIX_SECONDS,v1=HEX_HMAC_SHA256. Sign timestamp + "." + the exact raw request body with your secret. Use constant-time comparison and reject timestamps more than five minutes from your clock. Persist each event ID before returning 2xx. Delivery is at least once and may arrive out of order. Events cover account order activity, including website orders. Fetch status for current delivery and refund details; polling remains the reconciliation fallback. Failed delivery retries up to eight times with backoff; redirects are rejected.
Angalia hali ya HTTP na sehemu ya hitilafu ya JSON. Makosa ya uthibitishaji hutumia HTTP 400; wapigaji simu wa API hawaelekezwi kuingia. Andika makosa ya kiufundi faraghani na uwaonyeshe wateja ujumbe usioegemea upande wowote.
Add responses replay for 24 hours. After expiry, the same key can create another order: reconcile first. REQUEST_IN_PROGRESS permits the same request/key after Retry-After. IDEMPOTENCY_CONFLICT requires restoring the original payload. ACTION_OUTCOME_UNCONFIRMED requires support review: never change keys to bypass it. PRICE_LIMIT_EXCEEDED means no debit or order was committed. Log request_id (also X-Request-Id) for support.
HTTP
Hitilafu / hali
Cha kufanya
400
Invalid API key
Angalia ufunguo na sehemu zinazohitajika. Sahihisha ombi kabla ya kujaribu tena.
402
Insufficient balance
Weka pesa kwenye pochi ya akaunti kabla ya kutuma agizo tena.
409
A matching API order request is already being processed
Subiri kabla ya kujaribu tena ombi linalofanana na ufunguo wake asili wa utambulisho.
409
This idempotency key was already used for a different API order request
Rejesha mzigo wa awali wa malipo kwa kujaribu tena. Tumia kitufe kipya kwa mpangilio mpya wa kimantiki pekee.
415
Unsupported content type
Tuma JSON, sehemu za fomu zilizosimbwa na URL, au sehemu nyingi za maandishi.
423
Account suspended (message varies)
Tatua kizuizi cha akaunti kwa usaidizi; usijaribu tena na tena.
429
Too many requests. Please slow down and try again shortly.
Subiri kipindi cha Jaribu tena Baada ya muda, kisha ujaribu tena kwa kuzima.
500 / 503
Server failure or temporary unavailability (message varies)
Rudi nyuma. Kwa mawasilisho ya agizo, weka ufunguo sawa wa upakiaji na utambulisho.
Jaribu tena agizo bila kuchaji mara mbili
Unda na uendelee na ufunguo_wa_idempotency_wa kipekee kwa kila agizo la kimantiki kabla ya kutuma nyongeza. Badilisha ufunguo wa mfano na thamani yako ya kipekee.
Ruhusu hadi sekunde 60 kwa ombi la seva. Baada ya sekunde 20, onyesha ujumbe unaosubiri kwa mteja huku ombi la nyuma likiendelea.
Ikiwa hakuna jibu linalofika, jaribu tena mzigo uleule wa malipo na ufunguo uleule baada ya kuchelewa. Usitoe ufunguo mpya. Jaribio lililokamilika hurejesha jibu na X-Idempotent-Replay: true.
Ukishapokea Kitambulisho cha agizo, kihifadhi na utumie hali kufuatilia agizo hilo. Jibu lililowekwa kwenye foleni linamaanisha kukubaliwa kwa ajili ya kutimizwa, si kukamilika kwa uwasilishaji.
Vichwa vya habari vya Idempotency-Key na X-Idempotency-Key pia vinaungwa mkono. Bila ufunguo wa mteja, agizo bado linaweza kuwasilishwa, lakini kujaribu tena baada ya muda kuisha hakuwezi kutambua jaribio la awali kwa usalama.
Vikomo vya viwango
Vikwazo ni maalum kwa vitendo na vinaweza kusanidiwa. Kwenye HTTP 429, heshimu Jaribu-Baada ya (sekunde). Bila kichwa hicho, tumia kiendelezi cha kielelezo na jitter, kwa mfano 2, 4, 8, kisha sekunde 16 pamoja na ucheleweshaji mdogo wa nasibu. Jaribio lililofungwa na kuonyesha hitilafu zinazoendelea kwa opereta wako.
Weka kashe katalogi iliyochukuliwa na POST /api/v3 na action=services. Iburudishe mara kwa mara na uthibitishe vitambulisho vya huduma vya sasa, viwango, na vikwazo vya chini/max kabla ya kuagiza.
Mzunguko wa maisha wa agizo
Tuma kitendo=hali na kitambulisho kimoja cha agizo kwa kila ombi. Kama sera ya mteja anayeanza, piga kura kila sekunde 30, kisha ongeza muda wa maagizo yanayoendelea; heshimu mipaka ya kiwango. Maombi ya kutatanisha katika maagizo. Vizuizi vya wavuti havitumiki kwa sasa.
queued → pending → processing
Hali zinazotumika: endelea kupiga kura. Maagizo yanaweza kuruka hali za kati.
completed · partial · refunded · canceled
Hali za kituo: kusimamisha upigaji kura wa kawaida wa uwasilishaji. Uwasilishaji wa sehemu haukuwa kamili; kagua ada na mabaki. Maombi ya kujaza tena na kughairi yanategemea ustahiki wa huduma na agizo.
unknown
Hali isiyotambulika; usiichukulie kama mafanikio au weka agizo mbadala kiotomatiki. Jaribu tena hali kwa kutumia njia ya kurudi nyuma na wasiliana na usaidizi ikiwa itaendelea.
Vidokezo vya ujumuishaji kwa matumizi ya uzalishaji
Tumia API kama miundombinu. Madokezo haya yanashughulikia mambo muhimu pindi tu unapoendesha maagizo ya kiotomatiki, paneli ya mteja au eneo la mbele la duka la ujazo wa juu.
Salio la mkoba lililoshirikiwa
Maagizo ya moja kwa moja, maagizo ya mbele ya duka na maagizo ya API yote yanatokana na salio sawa la pochi. Ifadhili kutoka kwa kituo chochote, itumie kutoka kwa kituo chochote.
Linda ufunguo wako
Usiwahi kufichua ufunguo, jina la mpangishaji wa API, jina la mtoa huduma aliyesanidiwa, au hitilafu ghafi za usafiri katika msimbo wa upande wa mteja au ujumbe wa mbele ya duka. Simu za seva mbadala kupitia mazingira yako ya nyuma, andika maelezo ya kiufundi kwa faragha, na baada ya sekunde 20 waonyeshe wateja maneno yasiyoegemea upande wowote kama vile: Uwasilishaji wa agizo unachukua muda mrefu kuliko inavyotarajiwa. Angalia maagizo yako kabla ya kujaribu tena.
Majibu ya haraka
Je, ninapataje ufunguo wa API?
Ingia katika SMM Africa, fungua Akaunti, nakili ufunguo wako wa API na uzungushe kutoka sehemu moja wakati wowote.
Je, API ni bure?
Hakuna ada ya ziada ya API. Unalipa tu huduma unazoagiza. Mkoba sawa hufadhili maagizo ya moja kwa moja, maagizo ya mbele ya duka na maagizo ya API.
Je, viwango vya viwango ni vipi?
Vikomo ni mahususi na vinaweza kubadilika. Simu nyingi za nafasi, kura za hali ya kundi, na API inaporudi 429 subiri kipindi cha Jaribu tena baada ya muda kabla ya kujaribu tena.
Je, ninapaswa kushughulikia vipi majaribio tena?
Tuma kichwa kimoja cha kipekee cha Idempotency-Key au sehemu ya ufunguo_idempotency kwa kila agizo la mantiki la kuongeza. Ikiwa ombi limeisha, jaribu tena upakiaji sawa na ufunguo sawa ili jaribio lililokamilika lirudiwe bila malipo mengine.
Je, kuna mtandao?
Upigaji kura wa hali ndio njia inayotumika leo. Gonga hatua ya hali ya maagizo unayotazama na uhifadhi matokeo katika mfumo wako mwenyewe.
Ni nchi gani zinazotumika?
API inapatikana duniani kote, ikiwa na usaidizi mkubwa kwa masoko ya Afrika na ufadhili wa pochi unaotumia M-Pesa.
msamiati wa API
Wauzaji wa Masharti wanapaswa kuelewa
API ya Muuzaji
Kiolesura cha seva-kwa-seva ambacho huruhusu paneli nyingine au mtiririko wa kazi mahali na kufuatilia maagizo ya SMM Africa kutoka kwa matumizi yake yenyewe.
Katalogi ya huduma
Orodha ya moja kwa moja ya vitambulisho vya huduma, bei, vikomo, usaidizi wa kujaza upya na usaidizi wa kughairi unaotumika kabla ya kuagiza.
Kitendo
Sehemu ya JSON inayochagua utendakazi wa API, kama vile salio, huduma, ongeza, hali, jaza upya au ghairi.
Kuagiza kwa kutumia Wallet
Muundo wa kuagiza ambapo maagizo ya moja kwa moja, mbele ya duka, na API yote yanatokana na salio la pochi la SMM Africa linalofadhiliwa.