Interactive API
The BindID Service HTTP /interactive
endpoint is used to start a BindID end user interactive flow, such as transfering trust to new devices. The endpoint is called using the URL returned in a Flow Initialization API response. This endpoint responds by loading a webpage in the browser to execute the interactive flow. Upon successful completion of the flow, the browser is redirected to the redirect URI you provided in the Flow Initialization API request.
HTTP Request
The API is invoked as a GET request to the URL returned in an Flow Initialization API response. For example:
Response Headers
The POST response includes the following HTTP headers:
Header Name | Description |
---|---|
Content-Type | Returns application/html |
Response Body
The response to a successful request is an HTTP 200 response with status OK.
Completed Flow
After the user completes the flow, the browser is redirected to the URL defined in the Flow Initialization API request with the following URL parameters:
Parameter | Description | Type |
---|---|---|
response_code | For successful flows, ok ; for unsuccessful flows, not_ok . | String |
state | State value of the authorization request, only returned when sent as part of the Flow Initialization API request. | String |