Helpful hints when programming for Postback URL and DSU

Variables vs. Export Template

When using Postback URL you can define what your server receives based on an Export Template.

Notes:

  1. Adding your own KEY.  Until API 2.0 is released (Q4 2019), 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.
  2. The IP addresses for whitelisting are shown on the Account page under the API tab.

Echo Postback

If you want to see what is posted to your server, you can put an ‘echo’ at the beginning of your postback. In that way the post received will be emailed to you.  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. So, 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

Note: You also need to consider when the answers are submitted. If you have pre-submit questions, the answers will come with the one post. If you have post-submit questions then you will receive two posts with the same ID for you to know the relation.

in