Authentication
- Your application must authenticate using an API key.
- API keys are provided in the Cisco Spaces Partner Dashboard.
- Cisco Spaces Firehose API provides Production/Sandbox/Staging API keys.
- The sandbox or staging key must be used during development or testing to ensure events to the production application are not diverted to your development or test instance of your application.
HTTP: API key is passed to the HTTP endpoint as X-API-KEY header.
To get a quick preview of the incoming events, use the below curl command after replacing ENDPOINT_DOMAIN and API_KEY with your respective region endpoint and API Key.
curl "https://<ENDPOINT_DOMAIN>/api/partners/v1/firehose/events" -H "X-API-Key: <API_KEY>"
gRPC: The API key is passed as a part of gRPC metadata with X-API-KEY as metadata name and the API key as the value.
Note: No additional role or scope is needed for Cisco Spaces Firehose API other than an access key from the Cisco Spaces Partner Dashboard.