Document that current user's bookings are returned if zones AND user are not specified

[w-le]

https://placeoscalendar.docs.apiary.io/#reference/0/bookings/query-bookings

Either zones OR user MUST be specified. Otherwise there is no search criteria. The system will NOT search ALL bookings across all zones when zones is not supplied

Currently when the request is made when zones and user are not specified, the result will ALWAYS be [] because nothing is being searched. This is not obvious to the end user though.

A better response would be something like "400: Either zones or user param MUST be specified"

Currently, when the request is made when zones and user are not specified, the result will return the current user's bookings.
This behaviour should be documented in the API reference.

[w-le]

@stakach can help @chillfox with this one

[chillfox]

Hi @w-le,
Looks like it returns the bookings for the current user when no user or zones are specified.
Could take a look at this test and see what is different?

ee1699e

[w-le]

That is intuitive behaviour actually. So yeah if it's confirmed that that is working as expected then no code change is required, we'll just update the apiary and any other documentation to let end users know

[caspiano]

@w-le would you prefer if I open a tracking issue for any relevant documentation changes, or just reopen this one?

[w-le]

Let's just reuse this one and update the title and description

…

On Tue, 18 Jan 2022, 10:03 am Caspian Baska, ***@***.***> wrote: @w-le <https://github.com/w-le> would you prefer if I open a tracking issue for any relevant documentation changes, or just reopen this one? — Reply to this email directly, view it on GitHub <#140 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ACPJ7KBXKO5KKTY5U6O7PWDUWTDAVANCNFSM5LVKCDSA> . Triage notifications on the go with GitHub Mobile for iOS <https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675> or Android <https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub>. You are receiving this because you were mentioned.Message ID: ***@***.***>