Document rate limits and credits spending in OpenAPI

[Martin Kolárik]

• in a case like #474, the client should hint that lowering the limit will resolve the issue.
• on 429 errors clients should probably print rate limit details.
• clients supporting infinite mode should print info about that case