Authentication: API keys and safe retries
Every request carries one of your app's API keys in the Authorization header. Create keys in the console under Apps.
Authorization: Bearer echo_sk_<key id>_<secret>- Keep keys on your server only. Never put a key in a phone app, a web page or a repository.
- A key belongs to one app; usage and webhooks are tracked per app.
- Revoked keys stop working within 30 seconds.
- The secret is shown once when you create the key. Echo stores only a hash of it.
Safe retries
Every POST needs an Idempotency-Key header. If a request is repeated with the same key, Echo returns the first answer and does nothing twice.
- Idempotency-Key
- A unique value per operation (8 to 64 letters, digits, - _ . :).
- Idempotent-Replay: true
- Set on an answer that was replayed from the first request.
- 409 request_in_progress
- The first request with this key is still running.
- 422 idempotency_key_reused
- The key was used before with a different body.
