Blitline runs your jobs asynchronously, which means that after you submit your job, there will be a variable amount to time before your job has completed.
There are 2 ways for you to know that your job has completed: Postbacks and polling.
Postbacks are when the Blitline cloud machine calls your server back with JSON, thus notifying you that you job has completed.
Polling is when you ask Blitline “is the job done yet?”
Whether you are polling or using postbacks, you will get some JSON representing the results of the job processing.
The JSON returned will always have a results as the root node. Under results will be the following nodes:
Postbacks are the recommended way to use Blitline. Postbacks scale as large as you want to scale. Need 8 million postbacks/hr, no problem.
You can idenify you postback location by adding a postback_url to your job JSON. This url will be called as soon as the job has completed.
Polling is great for development, and sometimes necessary in certain use cases.
Polling has rate limits though. You will not be able to poll for 8 million job_ids. In fact the limit is about 5 per second per application ID.
You can read specifics here about our polling.
YES! We highly recommend http://requestb.in/ . This allows you to make a free http destination url, which you can use for your postback_url. This allows you to easily inspect what Blitline is posting back to your client before you even build the client.