Create Release

The post body should contain the bin ID as a JSON object:

{
    "bin": {
        "id": 123456
    }
}

Returns a release object if the call succeeded.

Example Workflow

1. Create a bin release (POST), specifying the bin ID that needs to be opened. Note the release ID from the response.
2. Prompt the user to press the flashing button on the SmartBox to open their key bin.
3. Periodically retrieve (GET) the bin release using the release ID. Note the state of the bin release from the "retrieved", "completed" and "expired" properties.
   • Use the "retrieved" flag to determine if the release was retrieved by the box. A release that was retrieved but never completed may indicate a connection issue.
   • If "completed" becomes true, stop retrieving the bin release data, the bin was successfully opened.
   • If "expired" becomes true, stop retrieving the bin release data, display an error and prompt the user to try again.