‘API’ Archive

UnlockBase is proud to present a new and very innovative feature called ICDN for Instant Code Delivery Notication. Stop wasting your precious server resources today ! It reduces your bandwidth consumption and CPU Cycles and can create HUGE savings on your hosting plan, as well as increase your whole system reactivity.

Thanks to the new ICDN you can do so, by simply entering a URL on your Account Settings page and deploying a simple listening script on your server.

How does it work ?

Everytime an order (either by using our Web Interface, or API) is delivered to us, we instantly send an HTTP or HTTPS POST request to your server (using the provided URL) with all the informations required for you to process the delivery on your side. These are:

  • ID – ID of the order in our system
  • IMEI or MEID – The serial number of the phone concerned by this delivery.
  • Comment – The comment field as you entered when placing the order.
  • ToolID – The ID of the Unlockbase service used to process this order.
  • ToolName – The friendly name of the Unlockbase service used to process this order.
  • Status – Either ‘Delivered’ or ‘Unavailable’ indicating whether we were able to calculate a code for your phone.
  • Code – If Status is Delivered, you will find the Unlock Code here.
  • CallbackURL – The URL that is being called with this data (needs to be here for technical reasons).

The listening script uses this information to process the order on your side ! You don’t have to call the UnlockBase server on a regular basis to check the status of your orders anymore, which will save you a lot of trouble as well as precious resources. Please make sure that your listening script will return an HTTP/200 OK code and that the reply contains the string <!–success–>, otherwise we will consider that your server is down and attempt to resend the notification for up to 16 hours !

To setup your ICDN URL, just go to the “Settings” section of your UnlockBase account.

UnlockBase API v3.0

We just update our API to v3.0, there is just very little change:

CheckMend support
– Error Fixes for PHP >5.4

It’s not mandatory to upgrade to API v3.0 and API v1.0 & v2.0 is still working ! You can access to all Documentation at this URL: http://www.unlockbase.com/xml-api-v3.php (You need to be logged in your UnlockBase account to be able to access this URL)

The HTC Widget (Tool Advisor) is still on a separate API:

 HTC Tool adviser Download

HTC  Factory Code (New Records)

With 3 different services to Unlock the HTC using Factory on UnlockBase, we’re the first direct source with the most up to date database (fresh records uploaded weekly on SuperNew Records Database).  But even if we provide instant delivery 24/7 for HTC, we understand it’s sometime annoying for our customer to quote a price to their customer with 3 different service <> pricing :

– HTC Regular (2005 <> February 2010)
– HTC New Records (February 2010 <> 25 Mai 2010)
– HTC Supernew Records (25 Mai 2010 <> Today)

To help you in this issue, we just release a small Widget that will help you to know instantly what’s the cheapest HTC unlock tool to use to request your code. For this you just need to submit the IMEI of your HTC using the Widget below and we’ll answer you in real time without any upfront cost witch tool you should use :

 HTC Tool adviser Widjet
Click Here to open the HTC Tool Adviser

Webmaster & API developers : We also release an API just for you so you can offer this Widget brand free on your website to redirect your customers directly to the right tool, at the right price. For more information about how to implement this Widget on your site, please check this post on the forum : http://forum.unlockbase.com/showthread.php?t=5787