Integrate with Stream Events (0.1)
Download OpenAPI specification:Download
This is a spec for integrating with Stream Events. Please send any feedback or questions to marc@streamorders.com.
Event Handler
This endpoint will be provided by the partner and Stream will send all events to it
header Parameters
X-Stream-Signature required | string |
Request Body schema: application/json
One of
type required | string |
location_id required | string |
reference_id | string Provider Reference ID for Event |
required | object (LocationOrder) |
Responses
Request samples
- Payload
Content type
application/json
Example
{- "type": "order.confirmed",
- "location_id": "loc_123",
- "reference_id": "your_id_123",
- "order": {
- "delivery_address": {
- "address_line_1": "123 Sesame St",
- "city": "Brooklyn",
- "state": "NY",
- "postal_code": "11201",
- "country": "United States"
}, - "id": "string",
- "customer": {
- "name": "string",
- "phone": "string",
- "masked_phone_code": "string"
}, - "currency": "usd",
- "dsp_order_id": "string",
- "dsp_order_number": "string",
- "estimated_fulfillment_time": 1709162320485,
- "fulfillment_type": "merchant_managed_delivery",
- "fulfillment_instructions": "string",
- "special_instructions": "string",
- "source": "string",
- "status": "in_progress",
- "subtotal": 0,
- "tax": 0,
- "driver_tip": 0,
- "delivery_fee": 0,
- "delivery_fee_tax": 0,
- "items": [
- {
- "name": "string",
- "quantity": 0,
- "price": 0,
- "special_instructions": "string",
- "modifiers": [
- {
- "name": "string",
- "quantity": 0,
- "price": 0
}
]
}
], - "total": 0
}
}
Response samples
- 201
Content type
application/json
"string"
Send Webhook Event (Event Provider -> Stream via Webhook)
You will call this endpoint from your system, This is how you will notify Stream with updates.
header Parameters
Stream-Webhook-Signature | string The HMAC-SHA256 signature of the request body, using the webhook secret as the key. |
Request Body schema: application/json
One of
type required | string Default: "order.assign.driver" |
required | object (GenericEventProviderAssignDriverObject) |
Responses
Request samples
- Payload
Content type
application/json
Example
{- "type": "order.assign.driver",
- "object": {
- "location_id": "string",
- "order_id": "string",
- "driver": {
- "name": "string",
- "phone": {
- "number": "string",
- "code": "string"
}
}
}
}