application programming interface (api) · 8.3.2 asp .net (vb net) call send message...

Application Programming Interface (API) Version 1.0

Click Next Company Limited.

[Last update: 22 March 2012]

เนอหา 1. ความหมายของ Application Programming Interface : API ........................................................................... 1

2. ประโยชนของ API ........................................................................................................................................ 1

3. ประเภทของ API .......................................................................................................................................... 1

4. ชองทางการเชอมตอ ..................................................................................................................................... 2

4.1 ตรวจสอบเครดตคงเหลอ (Check Credit) .................................................................................................. 2

4.2 สงขอความ (Send Message) ................................................................................................................... 2

5. พารามเตอรในการเชอมตอ ............................................................................................................................ 2

5.1 Check Credit ......................................................................................................................................... 2

5.2 Send Message ...................................................................................................................................... 2

6. ขอความตอบกลบจากระบบ .......................................................................................................................... 2

7. ตารางขอผดพลาด ........................................................................................................................................ 3

8. ตวอยางการเชอมตอ API .............................................................................................................................. 4

8.1 เชอมตอ API ดวยภาษา PHP .................................................................................................................... 4

8.1.1 PHP Call Check Credit ...................................................................................................................... 4

8.1.2 PHP Call Send Message ................................................................................................................... 4

8.2 เชอมตอ API ดวยภาษา ASP.NET(C#.NET) .............................................................................................. 5

8.2.1 ASP.NET(C#.NET) Call Check Credit ................................................................................................ 5

8.2.2 ASP.NET(C#.NET) Call Send Message ............................................................................................. 5

8.3 เชอมตอ API ดวยภาษา ASP.NET(VB.NET) .............................................................................................. 6

8.3.1 ASP.NET (VB.NET) Call Check Credit ............................................................................................... 6

8.3.2 ASP.NET (VB.NET) Call Send Message ............................................................................................ 6

8.4 เชอมตอ API ดวยภาษา JSP ..................................................................................................................... 7

8.4.1 JSP Call Check Credit ....................................................................................................................... 7

8.4.2 JSP Call Send Message .................................................................................................................... 7

9. ดาวโหลดโคดตวอยางโปรแกรม ..................................................................................................................... 8

10. ขอมลเพมเตม .............................................................................................................................................. 8

ClickNext Company Limited.

128/276 25th FL. Phayathai Plaza Bldg. Phayathai Road.,Rajtaewee. Bangkok., 10400, Thailand. Tel : (66)2-214-4180 Fax : (66)2-612-9783

1 Application Programming Interface(API) by ClickNext Co.,Ltd. Version 1.0 last update: 22 March 2012

1. ความหมายของ Application Programming Interface : API

API ยอมาจาก Application Programming Interface คอชองทางการเชอมตอเพอแลกเปลยนขอมล

จากระบบหนงไปสระบบอนๆ โดยผาน library (Function/module/utility) ของผสรางหรอใหบรการ API เพอให

ผพฒนาระบบอนๆ สามารถเชอมตอกบ API ของผ ทเปดใหบรการได

API ชวยใหเราสามารถพฒนาระบบไดงายและรวดเรวขน เปนระบบมากขน โดยทเราไมตองเขาใจหรอ

ไปแตะตองโคดของ API แครวาตองท างานยงไง เรยกใชยงไง สงคาอะไร และไดรบคาอะไรกลบมากพอ

ส าหรบ Web Developer หรอนกพฒนาเวบไซต API กคอรปแบบค าสงทนกพฒนาจะตองเรยกใชเมอ

ตองการเขาถงขอมลบนเวบไซตทมการเปด API ไวให การเขาถงขอมลอาจเปนทงการน าขอมลออกมา หรอเปน

การสงขอมลเขาไปกได API จงเปนเสมอนภาษาทคอมพวเตอรใชคยกบคอมพวเตอรเพอแลกเปลยนขอมลกน

ระหวางเครอขาย (Server) กบผ ใช (Client) หรอ Server กบ Server ดวย

2. ประโยชนของ API

- สามารถรบสงหรอเชอมตอเพอแลกเปลยนขอมลขาม Server ได

- ไมจ าเปนตองเขาหนาเวบหลก กมขอมลของเวบหลก จากเวบทดง API

- ท าใหผพฒนาระบบสามารถพฒนาไดงายและรวดเรวขน

3. ประเภทของ API

- เอพไอทขนกบภาษา (language-dependent API) คอ เอพไอ ทสามารถการเรยกใชจากโปรแกรมทเขยน

ขนดวยภาษาเพยงภาษาใดภาษาหนง

- เอพไอไมขนกบภาษา (language-independent API) คอ เอพไอ ทสามารถเรยกไดจากโปรแกรมหลายๆ

ภาษา




4. ชองทางการเชอมตอ

4.1 ตรวจสอบเครดตคงเหลอ (Check Credit)

SSL URL: https://member.smsmkt.com/SMSLink/GetCredit/index.php

4.2 สงขอความ (Send Message)

SSL URL: https:// member.smsmkt.com/SMSLink/SendMsg/index.php

5. พารามเตอรในการเชอมตอ

5.1 Check Credit

(1) User คอ Username ส าหรบใชในการเชอมตอเพอขอขอมล

(2) Password คอ Password ส าหรบใชในการเชอมตอเพอขอขอมล

5.2 Send Message

(1) User คอ ชอผใชงานส าหรบใชในการเชอมตอเพอขอขอมล

(2) Password คอ รหสผานส าหรบใชในการเชอมตอเพอขอขอมล

(3) Msnlist คอ เบอรโทรศพททตองการสงขอความ ไมเกน 1,000 เบอร เชน 0896702xxx;

0858331xxx;

(4) Msg คอ ขอความทตองการสงตองอยในรป application/x-www-form-urlencoded เทานน

(5) Sender คอ Sender name ทใชในการสงขอความตองเปน Sender name ทมอยในบรษทของ

ตวเอง เทานน

6. ขอความตอบกลบจากระบบ

- กรณทสงขอมลถกตองส าเรจ

Status = 0, Detail = รายละเอยด

- กรณสงขอมลผดพลาด

Status = -XXX (Error Code), Detail = YYY (รายละเอยดขอผดพลาด)

https://member.smsmkt.com/SMSLink/GetCredit/index.php




7. ตารางขอผดพลาด

สถานะ รายละเอยด ค าอธบาย

-101 Parameter not complete. ปอนพารามเตอรไมครบ -102 Database is not ready. ฐานขอมลไมพรอมใชงาน -103 Invalid User / Invalid Password. ชอผใชงานหรอรหสผานไมถกตอง -104 Invalid Mobile format. รปแบบหมายเลขโทรศพทไมถกตอง -105 MsnList length limit exceed. หมายเลขโทรศพทเกนจ านวนทก าหนด -106 Invalid your Sendername. ชอผสงไมถกตอง -107 Your account is expired. บญชผใชนหมดอายแลว -108 Quota Limit exceed. จ านวนเครดตคงเหลอไมพอส าหรบสงขอความ -109 System is not ready. Please try to post again later. ระบบไมพรอมใชงาน กรณาลองใหมอกครง -110 Your account has been Locked. บญชผใชถกลอคการใชงาน -111 Message Input Error. ขอความไมถกตอง เนองจากมอกขระพเศษอย -112 Mobile number blacklisted หมายเลขโทรศพทเปนเบอร Blacklisted




8. ตวอยางการเชอมตอ API

8.1 เชอมตอ API ดวยภาษา PHP

8.1.1 PHP Call Check Credit

ภาพประกอบท 1 ตวอยาง PHP Call Check Credit

8.1.2 PHP Call Send Message

ภาพประกอบท 2 ตวอยาง PHP Call Send Message




8.2 เชอมตอ API ดวยภาษา ASP.NET(C#.NET)

8.2.1 ASP.NET(C#.NET) Call Check Credit

ภาพประกอบท 3 ตวอยาง ASP.NET(C#.NET) Call Check Credit

8.2.2 ASP.NET(C#.NET) Call Send Message

ภาพประกอบท 4 ตวอยาง ASP.NET(C#.NET) Call Send Message




8.3 เชอมตอ API ดวยภาษา ASP.NET(VB.NET)

8.3.1 ASP.NET (VB.NET) Call Check Credit

ภาพประกอบท 5 ตวอยาง ASP.NET(VB.NET) Call Check Credit

8.3.2 ASP.NET (VB.NET) Call Send Message

ภาพประกอบท 6 ตวอยาง ASP.NET(VB.NET) Call Send Message




8.4 เชอมตอ API ดวยภาษา JSP

8.4.1 JSP Call Check Credit

ภาพประกอบท 7 ตวอยาง JSP Call Check Credit

8.4.2 JSP Call Send Message

ภาพประกอบท 8 ตวอยาง JSP Call Send Message




9. ดาวโหลดโคดตวอยางโปรแกรม

9.1 Source Code เชอมตอ API ดวยภาษา PHP

http://www.smsmkt.com/download/source/API/PHPCallAPI.zip

9.2 Source Code เชอมตอ API ดวยภาษา ASP.NET(C#.NET)

http://www.smsmkt.com/download/source/API/CSCallAPI.zip

9.3 Source Code เชอมตอ API ดวยภาษา ASP.NET(VB.NET)

http://www.smsmkt.com/download/source/API/VBCallAPI.zip

9.4 Source Code เชอมตอ API ดวยภาษา JSP

http://www.smsmkt.com/download/source/API/JSPCallAPI.zip

10. ขอมลเพมเตม

Technical : Thiraphong Office : 02-214-4180 #316 Mobile : 083-1662-154 E-mail : [email protected]

http://www.smsmkt.com/download/source/API/PHPCallAPI.zip

http://www.smsmkt.com/download/source/API/CSCallAPI.zip

http://www.smsmkt.com/download/source/API/VBCallAPI.zip

http://www.smsmkt.com/download/source/API/JSPCallAPI.zip

mailto:[email protected]

application programming interface (api) · 8.3.2 asp .net (vb net) call send message...

Documents