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.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.