companyLogo

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.

Documentation

Echo by ibotek