Article sections

    General Notes

    Recording Without Connectivity

    When using online service with Postback URL or DSU enabled, the scanning device needs Internet connectivity to validate against the online database.

    However, you can allow the app-user to record scans automatically without interruption if connectivity is lost. To do that, on the Advanced step you would need to enable “Auto-Sync” and also under “Auto-Next Scan” select the option “Always. (Save if error.) If the connection fails, log a record on-device and continue.”

    Using this feature, the scan isn’t validated but a record is saved on the device and auto-uploaded to the designated Postback or DSU URL when connectivity is restored.

    Adding Your Own Key

    Until API 2.0 is released, there isn’t an option to add a custom HTTP header to posts. Here are your current options:

    • To the URL you can add your own key; for example ?key=1234567890.
    • Another option is using the Export Template’s “Custom Field” option for the key. If you are using the API to create services, please look here for how to add a template to the service creation API.
    • Note: For Direct Scan to URL (DSU) you will only receive the default variables shown below since you cannot use an Export Template with DSU.

    Whitelisting

    You can find the IP addresses for whitelisting on your Account page under the API tab.

    Responding With HTML

    You need to escape what goes inside the text node. For example, you can’t just put “html” with brackets (general escaping examples here).

    Variables vs. Export Template

    When using Postback URL, you can define what your server receives based on an Export Template. When using DSU, the variables are not able to be structured with a template.

    Echo Postback

    If you want to see what is posted to your server, you can put an ‘echo’ at the beginning of your postback. Then, the post received will be emailed to you. Also, if placed at the beginning of your script, you should still get the email even if there’s a problem with your script.

    Though setting up an echo will vary based on your programming language, here’s one example:

    mail(“my@email.com”, “Echo POSTBACK”, print_r($_POST,true));

    Questions and Answers

    Treat answers not as a plain array but as an associative array or a dictionary where the keys are question IDs.

    A normal index array is this:

    answers[1] = answer X
    answers[2] = answer Y
    answers[n] = answer Z

    We are not posting it that way. We are posting based on the questions created and assigned to the service. Thus, given assigned questions with question id #1111 and #2222 to your service, when someone scans and submits the post will be:

    answers[1111] = answer for question id 1111
    answers[2222] = answer for question id 2222

    array for postback

    Important: First, you need to consider when you are submitting answers. For instance, if you have pre-submit questions, the answers will come with the one post. Moreover, if you have post-submit questions, you will receive two posts with the same ID for you to know the relation.

    in Developer APIs