100 solicitudes por minuto por clave, con X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset; al superarlo, 429 con Retry-After.
El límite
Cada clave puede hacer 100 solicitudes por minuto en la API externa, contadas por ventana de un minuto. Cada respuesta lleva los encabezados X-RateLimit-Limit (el tope), X-RateLimit-Remaining (cuántas caben aún en la ventana) y X-RateLimit-Reset (cuándo se renueva la ventana, en segundos Unix).
Al pasar el tope, la respuesta es 429 con el encabezado Retry-After indicando en cuántos segundos reintentar, y la misma información va en el cuerpo para los clientes que no leen encabezados.
Mantenerse bajo el límite
Lee X-RateLimit-Remaining y reduce el ritmo cuando baje. Para cargas iniciales grandes (alta de cientos de empleados), espacia las llamadas o divídelas en lotes por minuto. Las consultas paginadas cuentan una solicitud por página.
Scopes
Los scopes siguen el formato recurso:acción y se aplican por endpoint: employees:read para listar y leer empleados, employees:write para crear y actualizar, payroll:read para períodos y nóminas, payroll:write para abrir un período, calcular, aprobar y marcar como pagado, departments y positions en lectura y escritura, timeclock:read y timeclock:write para los registros de asistencia y reports:read para informes. Una clave sin el scope recibe 403, y ningún scope permite eliminar datos a través de la API.