Para generar una nueva clave de API, navegue a:Menú desplegable de la organización > Configuración de la organización > Claves de API > Generar nueva clave de API.
Rootly admite tres ámbitos de claves de API:
Tipo de clave de API
Permisos
Clave de API global
A las claves de API globales se les asigna el rol de Guardia y Respuesta a Incidentes cuando se generan. Los permisos del rol asignado controlan los permisos de la clave. Las claves de API globales pueden interactuar con todas las entidades dentro de su instancia de Rootly.
Clave de API de equipo
Las claves de API de equipo heredan los mismos permisos que un Administrador de equipo. Tienen acceso completo de lectura y edición a cualquier entidad de Rootly que el equipo posea, como los Horarios y Políticas de Escalación del equipo.
Clave de API personal
Las claves de API personales heredan los permisos del usuario que creó la clave de API.
JSON:API is a specification for how a client should request that resources be fetched or modified, and how a server should respond to those requests.
JSON:API is designed to minimize both the number of requests and the amount of data transmitted between clients and servers. This efficiency is achieved without compromising readability, flexibility, or discoverability.
JSON:API requires use of the JSON:API media type (application/vnd.api+json) para intercambiar datos.
Hay un límite predeterminado de aproximadamente3000GET llamadaspor clave de API cada60 segundos. El límite se calcula sobre unaventana deslizante de 60 segundos mirando hacia atrás desde el tiempo actual. Aunque el límite puede configurarse para admitir umbrales más altos, primero debe contactar a suGerente de Éxito del Cliente de Rootly para realizar cualquier ajuste.
Hay un límite predeterminado de aproximadamente3000PUT,POST,PATCH oDELETE llamadaspor clave de API cada60 segundos. El límite se calcula sobre unaventana deslizante de 60 segundos mirando hacia atrás desde el tiempo actual. Aunque el límite puede configurarse para admitir umbrales más altos, primero debe contactar a suGerente de Éxito del Cliente de Rootly para realizar cualquier ajuste.
La respuesta a la llamada de API devolverá el código de estado HTTP 429 - Límite de solicitudes excedido y Rootly no procesará el evento.
Se devolverán encabezados adicionales que le darán información sobre el límite:
RateLimit-Limit - El número máximo de solicitudes que se permite hacer al consumidor.
RateLimit-Remaining - El número de solicitudes restantes en la ventana de límite de tasa actual.
RateLimit-Reset - El tiempo en el que se restablece la ventana de límite de tasa actual en segundos de época UTC.