API ɗin SMS, SMPP API MS Scheduler API
Jagorar Mai Amfani
API ɗin SMS, SMPP API MS Scheduler API
| Gyara: | 6/24/2025 |
| Siga: | 1.7 |
| Marubuci: | Kenny Colander Norden, KCN |
Wannan daftarin aiki don wanda aka keɓance ne kawai kuma yana iya ƙunsar gata, na mallaka, ko wani bayanin sirri. Idan kun karɓi ta cikin kuskure, da fatan za a sanar da mai aikawa nan da nan kuma share ainihin. Duk wani amfani da daftarin aiki da ku an haramta.
Canja tarihi
| Rev | Kwanan wata | By | Canje-canje daga fitowar da ta gabata |
| 1.0 | 2010-03-16 | KCN | Ƙirƙiri |
| 1. | 2019-06-11 | TPE | An sabunta tamburan LINK |
| 1. | 2019-09-27 | PNI | Ƙara magana zuwa ƙayyadaddun SMPP 3.4 |
| 1. | 2019-10-31 | EP | Dubawa game da lokacin inganci tag |
| 1. | 2020-08-28 | KCN | Ƙarin bayani game da nau'ikan TLS masu tallafi |
| 2. | 2022-01-10 | KCN | An ƙara ƙarin bayani game da rahotannin isarwa Sabunta bayanai game da TLS 1.3 |
| 2. | 2025-06-03 | GM | Ƙara lambar sakamako 2108 |
| 2. | 2025-06-24 | AK | Ƙididdigar ƙara |
Gabatarwa
LINK Motsi ya kasance mai rarraba SMS tun 2001 kuma yana da gogewa sosai wajen aiki tare da masu aiki da masu tara haɗin haɗin gwiwa. An ƙera wannan dandamali don ɗaukar manyan kundin zirga-zirgar ababen hawa, kula da babban samuwa da kuma sauƙaƙa hanyoyin zirga-zirga ta hanyar haɗin gwiwa da yawa.
Wannan daftarin aiki yana bayyana hanyar sadarwa ta SMPP zuwa SMSC-dandamali da waɗanne sigogi da umarnin da ake buƙata da kuma waɗanne sigogi ke tallafawa.
Wannan daftarin aiki ba zai kula da takamaiman lokuta na amfani kamar haɗaɗɗen saƙonni, WAPpush, Flash SMS, da sauransu. Ana iya ba da ƙarin bayani game da waɗannan lokuta ta hanyar tuntuɓar tallafi.
Dokokin tallafi
Ya kamata a kula da uwar garken Motsi ta LINK azaman SMPP 3.4. Ana iya samun takamaiman bayani a hukumance a https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Ba a tallafawa duk hanyoyin, kuma an ƙayyade duk bambance-bambance a ƙasa.
4.1 Daure
Ana tallafawa umarnin ɗaure masu zuwa.
- Mai watsawa
- Transciever
- Mai karɓa
Alamomin da ake buƙata:
- system_id - samu daga goyan baya
- kalmar sirri – samu daga goyan baya
Matsaloli na zaɓi:
- addr_ton - ƙimar tsoho idan an saita TON zuwa Ba a sani ba yayin ƙaddamarwa.
- addr_npi – ƙimar tsoho idan an saita NPI zuwa Ba a sani ba yayin ƙaddamarwa.
Sigogi mara tallafi:
- adireshin_kewaye
4.2 Cire
Ana tallafawa umarnin cire haɗin.
4.3 Nemi hanyar haɗi
Ana tallafawa umarnin hanyar haɗin yanar gizo kuma yakamata a kira shi kowane daƙiƙa 60.
4.4 Gabatarwa
Ya kamata a yi amfani da hanyar ƙaddamarwa don isar da saƙonni.
Alamomin da ake buƙata:
- tushen_addr_ton
- tushen_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- zuwa_addr
- esm_class
- data_coding
- sm_tsawon
- gajeren_sako
Sigogi mara tallafi:
- service_type
- protocol_id
- fifiko_tuta
- time_delivery_time
- maye gurbin_if_present_flag
- sm_default_msg_id
Lura cewa load tag ba a tallafawa kuma ana iya isar da SMS ɗaya kawai a kowane kira kuma ana ba da shawarar cewa ingantaccen_period tag yana da darajar tsawon mintuna 15 aƙalla.
4.4.1 Shawarar TON da NPI
Ya kamata a yi amfani da TON da NPI masu zuwa lokacin aika saƙonni ta amfani da umarnin ƙaddamarwa.
4.4.1.1 Tushen
Abubuwan haɗin TON da NPI masu zuwa ana tallafawa don adireshin tushe. Duk sauran haɗe-haɗe za a ɗauke su a matsayin mara inganci. Za a yi amfani da tsohowar TON daga umarnin ɗaure idan an saita TON zuwa Unknown (0). Za a yi amfani da tsohowar NPI daga umarnin ɗaure idan an saita NPI zuwa Unknown (0).
| TON | NPI | Bayani |
| Harafi (5) | Ba a sani ba (0) ISDN (1) |
Za a kula da shi azaman rubutun mai aikawa Alphanumeric |
| Ƙasashen Duniya (1) | Ba a sani ba (0) ISDN (1) |
Za a kula da shi azaman MSISDN |
| Kasa (2) Ƙayyadaddun hanyar sadarwa (3) Lambar abokin ciniki (4) Taqaitaccen (6) |
Ba a sani ba (0) ISDN (1) Kasa (8) |
Za a kula da shi azaman gajeriyar lamba ta ƙayyadaddun ƙasa. |
4.4.1.2 Makoma
Abubuwan haɗin TON da NPI masu zuwa ana goyan bayan adireshin inda ake nufi. Duk sauran haɗe-haɗe za a ɗauke su a matsayin mara inganci. Za a yi amfani da tsohowar TON daga umarnin ɗaure idan an saita TON zuwa Unknown (0). Za a yi amfani da tsohowar NPI daga umarnin ɗaure idan an saita NPI zuwa Unknown (0).
| TON | NPI | Bayani |
| Ƙasashen Duniya (1) | Ba a sani ba (0) ISDN (1) |
Za a kula da shi azaman MSISDN |
4.4.2 Abubuwan da aka goyan baya
Ana goyan bayan rubututtuka masu zuwa. X na iya ƙunsar kowace ƙima.
| DCS | Rufewa |
| 0xX0 ku | Tsohuwar Alphabet GSM tare da tsawo |
| 0xX2 ku | 8-bit binary |
| 0xX8 ku | UCS2 (ISO-10646-UCS-2) |
Ƙidaya
5.1 Ƙididdigar Ƙididdigar Ƙididdigar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar Ƙimar XNUMX ta Ƙarshe).view
Ƙididdigar ƙididdiga ta bayyana matsakaicin adadin saƙonnin SMS waɗanda za a iya aikawa a cikin ƙayyadadden tazarar lokaci (kamar kowace rana, mako, wata, ko mara iyaka). Kowane keɓaɓɓen keɓaɓɓen an gano shi ta hanyar quotaId (UUID) kuma an sake saita shi bisa ga yankin lokaci na abokin ciniki. Ana iya sanya adadin ƙididdiga a ƙasa, yanki, ko matakin tsoho ta hanyar Quota Profile. Hakanan za'a iya ba da ƙima ta hanyar amfani da Taswirar Ƙidaya. Wannan taswirori na iyaye QuotaId (UUID) da maɓalli na musamman (misali, mai aikawa ko mai amfani) zuwa takamaiman keɓaɓɓen ƙididdiga.
An saita keɓaɓɓu daidai da tallafin gida, mai sarrafa asusun da aka ba ku ko ta tsohuwa idan ba a bayyana komai ba.
5.2 Matsayi na 106 - Ƙididdigar Ƙidaya ta wuce
Ana iya katange saƙon SMS tare da lambar matsayi 106 ("ƙaddamar da aka wuce") lokacin:
- Saƙon ya wuce ƙayyadadden ƙayyadaddun ƙayyadaddun ƙayyadaddun keɓaɓɓen keɓaɓɓen keɓaɓɓen sa a cikin tazarar yanzu.
- Ƙasar da za a nufa ba ta da wani keɓaɓɓen keɓe (watau, an toshe shi a sarari tare da taswirar ƙididdiga mara kyau a cikin profile).
- Babu wani keɓaɓɓen keɓaɓɓen keɓaɓɓen keɓanta kuma ba a fayyace ƙayyadaddun ƙididdiga ba, wanda ya haifar da ƙin yarda.
A cikin waɗannan lokuta, tsarin yana hana ƙarin sarrafa saƙo don tilasta abokin ciniki ko iyakokin tushen inda ake nufi da kuma guje wa yin amfani da su.
Rahoton bayarwa
Babu ɗaya ko isarwa ta ƙarshe tare da sakamako mai nasara/ gazawa da ke da tallafi.
Tsari akan rahoton isarwa: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx kwanan watan da aka yi: yyMMddHHmm stat:
Akwai ƙima a cikin matsayi:
- ISAR
- YA KASHE
- ƙin yarda
- BA DELIV
- GAME DA
6.1 Tsarin rahoton isarwa mai tsawo
Ana iya buƙatar ƙarin bayani a cikin rahotannin isarwa a cikin hulɗa da wakilin tallace-tallace na ku.
Tsarin kan rahoton isarwa: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 ƙaddamar kwanan wata:
yyMMddHHmm kwanan watan da aka gama: yyMMddHHmm stat: kuskure: rubutu:
Akwai ƙima a cikin matsayi:
- ISAR
- YA KASHE
- ƙin yarda
- BA DELIV
- GAME DA
filayen “sub” da “dlvrd” koyaushe za a saita su zuwa 000, kuma filin “rubutu” koyaushe zai zama fanko.
Duba lambobin Kuskuren babi don ƙimar filin “kuskure”.
Sigar TLS masu goyan baya
Ana buƙatar TLS 1.2 ko TLS 1.3 don duk haɗin TLS akan SMPP.
An dakatar da tallafin TLS 1.0 da 1.1 tun daga 2020-11-15. Sigar 1.0 da 1.1 na TLS tsofaffin ka'idoji ne waɗanda aka soke kuma ana ɗaukarsu azaman haɗarin tsaro a cikin jama'ar Intanet.
LINK yana ba da shawarar yin amfani da TLS sosai idan ana amfani da haɗin SMPP mara ɓoyewa a yau. Haɗin SMPP da ba a ɓoye ba an soke su daga 2020-09-01 ta hanyar LINK, kuma za a cire su nan gaba. Har yanzu ba a yanke ranar cire haɗin haɗin da ba a ɓoye ba tukuna.
Haɗin kai zuwa uwar garken SMPP na TLS yana a tashar jiragen ruwa 3601 maimakon ɓoyewa a tashar jiragen ruwa 3600.
Kuna iya har yanzu amfani da TLS ko da aiwatar da SMPP ɗinku baya goyan bayan TLS ta amfani da stunnel, duba https://www.stunnel.org/
Lambobin kuskure
Ana iya amsa lambobin kuskure masu zuwa a cikin filin kuskure idan filin ya kunna.
| Lambar kuskure | Bayani |
| 0 | Kuskuren da ba a sani ba |
| 1 | Kuskuren hanya na ɗan lokaci |
| 2 | Kuskuren hanya na dindindin |
| 3 | Matsakaicin matsawa ya wuce |
| 4 | Lokaci ya ƙare |
| 5 | Kuskuren da ba a san mai aiki ba |
| 6 | Kuskuren mai aiki |
| 100 | Ba a sami sabis ba |
| 101 | Ba a samo mai amfani ba |
| 102 | Ba a sami asusu ba |
| 103 | Kalmar sirri mara inganci |
| 104 | Kuskuren daidaitawa |
| 105 | Kuskuren ciki |
| 106 | Ƙidaya ta wuce |
| 200 | OK |
| 1000 | An aika |
| 1001 | Isar da |
| 1002 | Karewa |
| 1003 | An share |
| 1004 | Wayar hannu cike |
| 1005 | An yi layi |
| 1006 | Ba a kai ba |
| 1007 | Bayarwa, an jinkirta cajin |
| 1008 | An caje, ba a aika sako ba |
| 1009 | An caje, ba a isar da sako ba |
| 1010 | Ya ƙare, rashin rahoton isar da ma'aikaci |
| 1011 | An caje, an aika saƙo (ga mai aiki) |
| 1012 | An yi layi mai nisa |
| 1013 | An aika saƙo zuwa afareta, jinkirin caji |
| 2000 | Lambar tushe mara inganci |
| 2001 | Ba a tallafawa gajeriyar lamba azaman tushe |
| 2002 | Ba a tallafawa Alpha azaman tushe |
| 2003 | Ba a tallafawa MSISDN azaman lambar tushe |
| 2100 | Ba a tallafawa gajeriyar lamba azaman makoma |
| 2101 | Ba a goyan bayan Alpha a matsayin makoma |
| 2102 | MSISDN ba shi da tallafi azaman makoma |
| 2103 | An katange aiki |
| 2104 | Wanda ba a sani ba |
| 2105 | An katange hanya |
| 2106 | Kuskuren lamba |
| 2107 | An toshe wurin na ɗan lokaci |
| 2108 | Wuri mara inganci |
| 2200 | Kuskuren caji |
| 2201 | Mai biyan kuɗi yana da ƙarancin ma'auni |
|
2202 |
An hana masu biyan kuɗi don ƙarin caji (premium)
saƙonni |
|
2203 |
Abokin biyan kuɗi ya yi ƙaranci (don wannan musamman
abun ciki) |
| 2204 | Ba a yarda mai biyan kuɗi da aka riga aka biya ba |
| 2205 | Abokin biyan kuɗi ya ƙi sabis |
| 2206 | Ba a rajistar mai biyan kuɗi a tsarin biyan kuɗi ba |
| 2207 | Mai biyan kuɗi ya kai ma'auni max |
| 2208 | Ana buƙatar tabbatar da ƙarshen mai amfani |
| 2300 | An mayar da kuɗi |
|
2301 |
Ba za a iya mayar da kuɗi ba saboda bisa ka'ida ko ɓacewa
MSISDN |
| 2302 | An kasa mayar da kuɗi saboda ɓacewar saƙon Id |
| 2303 | An yi layi don maidowa |
| 2304 | Lokacin dawowa |
| 2305 | Rashin mayar da kuɗi |
| 3000 | GSM ba ta da tallafi |
| 3001 | UCS2 ba ta da tallafi |
| 3002 | Ba a tallafawa rufaffen binary |
| 4000 | Ba a tallafawa rahoton isarwa |
| 4001 | Abun cikin saƙo mara inganci |
| 4002 | Farashin farashi mara inganci |
| 4003 | Bayanan mai amfani mara inganci |
| 4004 | Maganin bayanan mai amfani mara inganci |
| 4005 | Ƙididdiga mara inganci |
| 4006 | VAT mara inganci |
| 4007 | Abubuwan da ba su da tallafi don manufa |
Takardu / Albarkatu
 |
API ɗin haɗin motsi motsi, SMPP API MS Jadawalin API [pdf] Jagorar mai amfani API ɗin SMS SMPP API MS Jadawalin API, API ɗin SMS API SMPP API, Mai tsara Jadawalin API, API ɗin Mai tsarawa, API |