Shotcode Decoding Service
ShotCode.com Decoding Service allows you to decode shotcodes on your account via API calls. The decoding process
is what takes place when someone scans a code on a mobile phone: the scanning sends the ID along with some unique identification
to ShotCode.com routing server, and then gets served with the desired URL. Just like the regular http call done by the mobile,
each call done by this service generates access statistics for the decoded code.
This is a signed service - that means it requires an API key in order to work.
Service Endpoint
https://www.shotcode.com/services/v1/decode_shotcode
Expected Parameters
- - api_key [your account api key]
- - id [the shotcode's id]
- - imei [a 15-character unique numeric identification of the caller]
Response Format
<decode_shotcode>
<shotcode id="[shotcode's unique id]" thumbnail="[url for a 150x150 png image]" image="[url for a 400x400 png image]" url="[shotcode's url]"/>
<errors>
<error code="[error code]">[some error message here]</error>
</errors>
</decode_shotcode>
Please note that there will only be one <shotcode> entry, and it will only be present when the shotcode is found and the access parameters are correct. also, there can be one or more <error> entries, one per error message (for example, if no api key was provided).
In case the <errors> node is present, no <shotcode> nodes will be shown.
Expected Error Codes
e001, e004, e027, e028, e029, e030. The full list of error codes can be seen on the error codes section.