How Motorserve Integration Works

Source: motorserve_controller.rb

• Rate limiting is enforced at 1 request per minute per session to prevent API overload
• The Motorserve API is restricted to business hours only: UTC 11:00-19:00 in production environments
• The integration is locked to a specific company ID, making it a single-tenant API — only one company can use it
• Logging in destroys all previous sessions for that user; a lockout mechanism exists for repeated failed attempts
• The default data retrieval timespan is 24 hours unless the full_history parameter is specified

Support scenarios

• "Motorserve API returns errors outside of business hours" → The API is restricted to UTC 11:00-19:00 in production. Requests outside this window will fail. Convert to the workshop's local timezone to determine the available window.
• "Motorserve requests are being rejected or throttled" → Rate limiting is 1 request per minute per session. If the workshop is making rapid requests, they will be throttled. Wait at least a minute between requests.
• "User got locked out of Motorserve" → The lockout mechanism triggers after repeated failed login attempts. Additionally, logging in destroys all previous sessions. Contact support to reset the lockout.
• "Another company wants to use Motorserve" → The integration is locked to a specific company ID. It is single-tenant by design and cannot be enabled for additional companies without code changes.