Document REST API Rate Limits and Connection Best Practices

[imfaruk]

We need public documentation for REST API rate limiting and connection requirements, similar to Twilio's approach:

• https://help.twilio.com/articles/360007130274-Requirements-for-Connecting-to-the-Twilio-REST-API-and-Troubleshooting-Common-Issues
• https://help.twilio.com/articles/115002943027-Understanding-Twilio-Rate-Limits-and-Message-Queues

Important Notes

• Avoid documenting specific rate limit numbers (e.g., requests per second)
• Keep it generic and applicable to all customers
• Focus on how to monitor and respond to limits, not what the limits are

Related

• Customer request: https://github.com/signalwire/cloud-product/issues/17759
• See Bryan's comment: https://github.com/signalwire/cloud-product/issues/17759#issuecomment-3987646453