List a Realtime app's keys
GET
/v1/realtime/apps/{realtime_app_id}/keys
bird realtime apps keys list <realtime-app-id>curl -X GET "https://us1.platform.bird.com/v1/realtime/apps/{realtime_app_id}/keys" \
-H "Authorization: Bearer $TOKEN" \
--url-query "include_revoked=false"Réponse200
{
"data": [
{
"id": "rak_01krdgeqcxet5s7t44vh8rt9mg",
"key": "d0e95a856ddc1b09d4c8",
"secret": "862925e1991a8b6902f9"
}
]
}
Returns the app's keys, oldest first. Non-revoked only by default; pass include_revoked=true to include revoked keys. An app can hold several keys at once (create a new key, roll it out, then revoke the old one for zero-downtime rotation). Secrets are never included in this response.
Paramètres
realtime_app_id
string
ID of the Realtime app (rap_ prefix), as returned when the app was created.
Paramètres de requête
include_revoked
boolean
When true, include revoked keys in the response.
Contenu de la réponse
data
array of object
obligatoire
The app's keys, oldest first. Revoked keys are excluded unless include_revoked=true.
Afficher les attributs enfants
data.id
string
obligatoire
data.key
string
obligatoire
The public app key clients use to connect.
data.secret
string
The key secret, used for server-side request signing. Returned only when the key is created, and never shown again: store it securely. If lost, create a new key and revoke this one.
data.revoked_at
nullable string
obligatoire
When the key was revoked, or null if still active.
data.created_at
string
obligatoire
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Explorer la fonctionnalitéRealtimeSuivre le parcours d'apprentissageBuild your first integrationGuide d'implémentationSend your first realtime event
Essayez la pratique et obtenez un guide d'implémentation