API Endpoint(s) and/or Zoom API Event(s)
/users/me/meetings?type=live
Description
I just wasted a few hours trying to debug some internal logic, and it turned out that your schemas are wrong and don’t represent the return values of the endpoint listed above. I’ve had this issue before and am fed up enough with it to post this rant.
Error?
Here’s the return value I got from the list my meetings endpoint:
{"page_size":30,"total_records":1,"next_page_token":"","meetings":[{"uuid":"UiXAeK7PSd29F7yj8E5Izw==","id":87861145172,"host_id":"v4Xy1yE1Rzul6MwNCxdFag","topic":"Nikhil Shinday's Zoom Meeting","type":1,"duration":2033796963,"created_at":"2023-02-28T15:02:12Z","join_url":"https://us06web.zoom.us/j/87861145172?pwd=SmM3d0JFLzlWd2ljeXBKK2p3aHc0UT09"}]}
page_number
and page_count
are completely missing from this response. There’s no indication from the API documentation or the associated JSON schema linked in docs that these should be missing. I verified that both the documentation and the public JSON schema don’t reflect this. It’s clear that Zoom is trying to focus on becoming a platform, and that part of your strategy in doing so is to build a developer community. Things like this make the DX awful and make me want to stay away from your API with a yard stick.
How To Reproduce
Used a Bearer token issued from Zoom’s OAuth endpoint to call the list meetings endpoint:
curl -XGET https://api.zoom.us/v2/users/me/meetings\?type\=live -H 'Authorization: Bearer <token>'