MarketlinkPH HTTP API Information Kit v3.00.pdf

MAKATI CORPORATE OFFICE SERVICES INC. / MarketlinkPH MARKETING SERVICES28/F Cityland Pasong TamoTower, 2210 Chino Roces, Makati City PHILIPPINES 1200Company Web Sites http://www.makaticorp.com http://www.marketlinkPH.comTel. No. +63-2 -893-8909 e-mail: info@makaticorp.com, info@marketlinkph.comFebruary 2013 v3.00Thank you for contacting us for your SMS HTTP API needs. MakatiCorp/MarketlinkPH SMS service isfeatured in the article "The Science Behind Text Blasting" in the Vol 5 No. 3 issue of ADEDGEMAGAZINE - the official magazine of the Philippine Association of National Advertisers (PANA). We havebeen into SMS since 2006. We have a wide range of SMS services to cater for just about any businessneed and your requirements in particular.REAL-TIME SMS SENDING FROM WEB/ONLINE SYSTEMWe can provide this functionality for your website via HTTP Application Programming Interface (HTTPAPI). The format will be similar to the example below** that sends “Hello” to 09228052922:**NOTE: actual will be given when we reach testing stagehttp://api.marketlinkph.com/mlinkhttpapi/sendsms/plain?user=MLINKDEMO01&password=xxxxxxxx&SMSText=Hello&GSM=639228052922We will fix the SenderID that will appear for your Account. The Sender canbe up to 11 alphanumeric if the goal is to capitalize on Brand Recognition orto strengthen Brand Building efforts, or, it can be set to a real, specific 11-digit number (for example, 09228052922) if the goal is to be able to captureresponses.The system provides Return Code of 0(positive, for successful posting). We also provide HTTP API for checkingremaining Credits, and Online Reports. Fees/Rates as shown below:• One-time Setup for MLINK API account PHP 35,000.00. Activation in 2 to 3 working days.TERMS: 50% upon commissioning. 50% balance due upon completion by way of acceptancetesting, training, and successful implementation of our components.• Purchase of Credits PHP 2.00/SMS for min. 5,000 to < 20,000 SMSPHP 1.50/SMS for min. 20,000 SMS CreditsTERMS: Full payment upfront as this is a PREPAID service. Credits can be used for HTTP APIcalls or for sending SMS directly from web interface – see http://www.branded-sms.com• Monthly Fee/Other Fees N/AThere is no hardware or software or modem/SIM needed on your site. All you need to do is to put in anHTTP call in your web source code at the point when you want the SMS to be sent out. It’s that simple.For more information about our MarketlinkPH services, please visit http://www.marketlinkph.com . TheBRANDED SMS page is http://www.marketlinkph.com/html/mlink_brandedsms.htm . Our IT Company isDigital Visions Philippines http://www.digitalvisionsinternational.com a premier provider of IT solutionsfounded in 1996 with notable local and international recognitions, including being the Recipient of 2004Excellence Award given by Computing Technology Industry Association, a global organization of morethan 10,000 companies and members.We are looking forward to rendering our service to your Company.Sincerely yours,Mr. Red ParedesMakati Corporate Office Services Inc.28th Floor Cityland Pasong Tamo Tower U28072210 Chino Roces Ave. (Pasong Tamo), Makati CityTrunkline (+632) 893-8909 ext 804MakatiCorp/MarketlinkPH is featured in the article "The Science Behind Text Blasting" in Vol 5 No. 3 issue of ADEDGEMAGAZINE - the official magazine of the Philippine Association of National Advertisers (PANA).

MAKATI CORPORATE OFFICE SERVICES INC. / MarketlinkPH MARKETING SERVICES28/F Cityland Pasong TamoTower, 2210 Chino Roces, Makati City PHILIPPINES 1200Company Web Sites http://www.makaticorp.com http://www.marketlinkPH.comTel. No. +63-2 -893-8909 e-mail: info@makaticorp.com, info@marketlinkph.comTECHNICAL NOTESThe HTTP API can be called from within your PHP module using file_get_contents() – the URL format touse is as follows (use variables in place of ):http:///plain?user=&password=&SMSText=&GSM=The HTTP API can also be invoked directly from any web browser during your testing stage.Calls to our HTTP API will give a return value that your program must trap and handle. >0 is successful.Any other codes (negative) means error. The summary of error codes are as follows:VALUEDESCRIPTION AND RECOMMENDED ACTION-2 Not enough credits – Purchase additional credits-3 Network not covered – Check for false prefix code 639xx-5 Invalid user or password – Note both are CaSeNsItIve-6 Missing destination address – Must have GSM=parameter-7 Missing SMS Text – Must have SMSText= parameter-9 Invalid format for destination address. Must be639xxxxxxxxx format, not 09xxxxxxxxx to eliminatecomplications with truncation of leading zero for numeric-10 Missing user – Must have user= parameter-11 Missing password – Must have password= parameter-13 Invalid destination address – Must be local number639xxxxxxxxx>0 Successful. Make sure to test fro >0 before proceedingAnother useful function we offer is checking of SMS credits. There are 3 ways:OPTION 1 Graphical Interface – Login at http://sms.marketlinkph.com with user and password. Creditsappear at upper leftOPTION 2 HTTP API using a browser.http:///command? user=&password=&cmd=CREDITSOPTION 3 HTTP API call within your PHP code. We highly recommend that you code such that youcheck your credits first – if you find that its below your “safe” threshold, send an email or SMS alert toyour designated contact for MarketlinkPH BRANDED SMS service so you can top up before you run outof credits. We can credit your account within 1 to 2 banking days upon receipt of payment via bank.