Mwongozo wa API ya Paneli ya SMM: Unda Mtiririko wa Kazi wa Muuzaji Unaothibitishwa

API ya SMM Africa ni kituo kimoja, chenye msingi wa vitendo kwa katalogi, salio, mpangilio, hali, kujaza upya na utendakazi wa kughairi. Inakubali JSON, sehemu zilizosimbwa na URL, na data ya sehemu nyingi za uga tu, kwa hivyo paneli za kawaida za wauzaji zinaweza kuunganishwa bila adapta.

API haiondoi tofauti za mtoa huduma au majukumu ya muuzaji. Muunganisho wa sauti huweka muhtasari wa sasa wa huduma, huweka kila mteja kwenye Kitambulisho cha agizo cha SMM Africa, huhifadhi lengo na kiasi kilichowasilishwa, na kuwasilisha hali na kurejesha pesa au kujaza upya ustahiki kwa usahihi.

Mwisho na uthibitishaji

Tuma ombi la HTTPS POST kwa https://smm.africa/api/v3 pamoja na JSON, application/x-www-form-urlencoded, au uwanja pekee multipart/form-data. Thibitisha na Authorization: Bearer YOUR_API_KEY au kiwango key uwanja. Sehemu zilizosimbwa za URL zinapendekezwa kwa paneli za kawaida za wauzaji.

curl -X POST https://smm.africa/api/v3 -H "Content-Type: application/x-www-form-urlencoded" --data-urlencode "key=YOUR_API_KEY" --data-urlencode "action=balance"

Weka ufunguo kwenye seva. Usiisafirishe katika JavaScript ya kivinjari, rununu, hazina ya umma, kumbukumbu zinazoonekana na mteja, matukio ya uchanganuzi au picha za skrini. Izungushe kutoka kwa vidhibiti vya usalama vya akaunti ikiwa inaweza kuwa imefichuliwa.

Vitendo sita vilivyorekodiwa

• huduma: hurejesha katalogi ya sasa ya huduma.
• salio: hurejesha salio la pochi na sarafu iliyoshirikiwa.
• ongeza: huwasilisha agizo la kitambulisho cha sasa cha huduma, lengo na kiasi.
• hali: hurejesha sehemu za uendeshaji kwa kitambulisho kimoja cha agizo la SMM Africa.
• kujaza tena: inaomba ukaguzi wa kujaza upya kwa agizo linalostahiki.
• ghairi: inaomba kughairiwa kwa agizo linalostahiki.

Vitendo vyote sita hutumia ncha moja. The action thamani huamua ombi na umbo la majibu.

Leta huduma kabla ya kufichua katalogi

Huu services jibu huandika kitambulisho cha huduma, jina, aina, kundi, bei, kiwango cha chini, kiwango cha juu, alama ya kujaza tena na alama ya kughairi. Mkataba wa v3 hutumia USD bila kutegemea sarafu inayoonyeshwa kwenye tovuti. Soma kila aina ya huduma: bei za kawaida za idadi hutumia msingi wa kwa kila 1,000, huku vifurushi vikiwa na kanuni tofauti za kutoza. Vitambulisho vya huduma, bei, vikomo, majina na alama vinaweza kubadilika, kwa hiyo usiviweke katika msimbo kama taarifa za kudumu za bidhaa.

Muuzaji anaweza kuweka akiba ya jibu ili liweze kutumika, lakini anapaswa kurekodi wakati lilipoletwa na kuonyeshwa upya kabla ya kukubali agizo. Ikiwa katalogi inayomkabili mteja itabadilisha jina au bei, weka kitambulisho asili cha huduma ya SMM Africa na maelezo yaliyoonyeshwa wakati agizo lilipofanywa.

Weka agizo na kitendo cha kuongeza

Kwa huduma ya Default, add hatua inahitaji service, link, na quantity. Aina nyingine za huduma hutumia sehemu zake zilizoandikwa kwenye mwongozo. Ya hiari runs na interval hutumika tu kwa huduma zinazooana za kulishwa kwa njia ya matone. Thibitisha lengo dhidi ya dokezo la huduma ya moja kwa moja na uweke kiasi kati ya kiwango cha chini zaidi na cha juu cha sasa.

{ "action": "add", "service": 1234, "link": "https://instagram.com/your-profile", "quantity": 500
}

Jibu lililofaulu huleta order thamani. Hifadhi kitambulisho hicho mara moja pamoja na rejeleo la mteja, picha ya huduma, lengo, kiasi kilichowasilishwa, malipo yanayotarajiwa na muhuri wa muda. Muuzaji anamiliki ramani hii; API haiwezi kubainisha mteja wa mwisho au ankara ni ya agizo.

Wakilisha hali kwa usahihi

Huu status kinakubali kitambulisho cha agizo cha SMM Africa. Jibu lililoandikwa linaweza kujumuisha malipo, hesabu ya kuanza, hali ya agizo, mabaki na sarafu. Lebo za hali zinazowezekana ni pamoja na Inasubiri, Inaendelea, Inachakata, Isiyo na Kiasi, Imekamilika, na Imeghairiwa.

Tumia sehemu hizi ili kuonyesha maendeleo ya agizo katika tovuti ya mteja. Weka kuripoti kwa kampeni kando na utumie uchanganuzi wa majukwaa ya kijamii kufikia, ushirikishwaji na mwitikio wa hadhira.

Kujaza tena na kughairi ni maombi, si ahadi

Huu refill na cancel vitendo vyote vinatumia kitambulisho cha agizo. Alama ya sasa ya huduma inaweza kuonyesha kama kitendo kimefichuliwa, lakini ustahiki wa mwisho bado unategemea huduma, hali ya agizo, muda, majibu ya mtoa huduma na sera iliyochapishwa.

Usiahidi mteja kwamba kila tone litajazwa tena au kwamba kila agizo lililowasilishwa linaweza kughairiwa. Hifadhi tangazo asili, agiza mihuri ya muda na majibu ili usaidizi uwe na ushahidi unaohitajika kwa ukaguzi.

Hitilafu katika kushughulikia na kupiga kura

• 400: kagua ombi na sehemu zinazohitajika.
• Hitilafu ya uthibitishaji ya 400: simama na uhakiki ufunguo; usijaribu tena vitambulisho batili mfululizo.
• 429: kuheshimu Retry-After kichwa na kurudisha nyuma.
• 500: rekodi rekodi ya uunganisho iliyorekebishwa na ujaribu tena kwa uangalifu badala ya kuunda nakala za maagizo.

Usiwahi kuingia kwenye tokeni kamili ya Bearer. Ikiwa kosa la mtandao hutokea baada ya kutuma add, angalia ikiwa agizo liliundwa kabla ya kuwasilisha ombi lile lile la mteja tena.

Mfuatano salama wa ujumuishaji

1. Soma nakala marejeleo ya API ya binadamu na Hati ya OpenAPI.
2. Jaribio la uthibitishaji na balance na uangalie mkondo services majibu.
3. Weka agizo dogo mwenyewe la kitambulisho halisi cha huduma na aina lengwa unayopanga kufichua.
4. Angalia hali ya agizo, utofauti wa muda, na tabia yoyote ya kujaza au kughairi.
5. Unda kiteja cha upande wa seva, muhtasari wa huduma, upangaji ramani, kumbukumbu zilizorekebishwa, na utunzaji wa viwango vya juu.
6. Eleza utoaji, jukwaa, uhifadhi, chaguo la usaidizi, na mipaka ya matokeo katika masharti ya mteja wako.

Mstari wa chini

API ya paneli ya SMM inaweza kurahisisha utendakazi uliojaribiwa. Tumia hati za sasa, weka kitambulisho cha huduma na kitambulisho cha agizo, linda ufunguo na uwasilishe hali ya agizo kwa usahihi kwa wateja.

Mabadilishano kamili ya agizo la kawaida

Thamani zilizo hapa chini ni za mfano, si vitambulisho halisi vya huduma, taarifa za siri za kuingia, bei au matokeo ya maagizo. Pata huduma kwanza na uchague huduma ya Default inayofaa. Kiasi chote cha v3 hutumia USD; sarafu inayoonyeshwa kwenye tovuti haibadilishi mkataba huo.

POST https://smm.africa/api/v3
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: example-client-order-001 { "action": "add", "service": 1234, "link": "https://instagram.com/your-profile", "quantity": 500
}

Mfano wa jibu lililofaulu:

{ "order": "example-order-id", "charged": 1.25 }

Hifadhi kitambulisho cha agizo kilichorudishwa, kisha uombe hali yake:

POST https://smm.africa/api/v3
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json { "action": "status", "order": "example-order-id" }

Kagua hali, mabaki, chaji, iliyosasishwa, na upya. Hali ya zamani ni taarifa iliyohifadhiwa kwenye akiba, si ukaguzi mpya wa mtoa huduma; muhuri wa muda wa kuonyesha upya unaokosekana haupaswi kuwasilishwa kama uthibitisho wa hivi karibuni. Tumia marejeleo ya OpenAPI kwa miundo kamili ya majibu na hali za hitilafu.

Shughulikia kuisha kwa muda bila kutozwa mara mbili

Weka ufunguo mmoja fiche wa idempotency kwa kila agizo la kimantiki na uhifadhi ombi lake kamili. Agizo lilelile likiishiwa muda, tumia tena ufunguo huo na taarifa zilezile ndani ya kipindi kilichoandikwa cha kurudia. Usiunde ufunguo mpya ili tu kupita mgongano. Majibu ya sasa ya add yanaweza kurudiwa kwa saa 24; baada ya kuisha, patanisha agizo la awali kabla ya kujaribu tena. Wateja wa kawaida wanaweza kutumia sehemu ya fomu idempotency_key badala ya kichwa.

Jibu la API au rekodi ya ndani ya agizo huthibitisha hali ya mchakato, si uhifadhi, ubora wa hadhira au matokeo ya biashara. Kamwe usiweke funguo kwenye msimbo wa upande wa mtumiaji, picha za skrini au uchanganuzi.

Tofauti za aina za huduma na hitilafu

Agizo chaguo-msingi hutumia kiungo na wingi. Kifurushi hutumia kiungo bila wingi. Maoni Maalum hupata wingi kutoka kwa mistari ya maoni, na usajili una sehemu zake. Chukua aina kutoka kwenye orodha na ufuate marejeleo ya sasa ya API badala ya kutuma kila sehemu kwa kila huduma.

Kushindwa kwa uthibitishaji wa utambulisho na taarifa kunaweza kurudisha HTTP 400 yenye ujumbe wa hitilafu; aina za maudhui zisizotumika hutumia 415, akaunti zilizosimamishwa 423 na vikomo vya kasi 429 vyenye Retry-After. Usirudie ombi lililokataliwa bila kulibadilisha. Subiri baada ya vikomo vya kasi na upatanishe maombi yenye matokeo yasiyojulikana kabla ya kujaribu tena baada ya hitilafu za seva au mtandao.