I am beyond frustrated with this api.. the documentation is horrible and as far as i can tell, you need to make 5 calls to add an event, i have been at this for 12 hours and i still cannot figure out how to simply query 1 appointment.. with bookingId, PageId, bookingref, i cant get any of them to give me all the values of an appointment! the best i can do is take the bookingid, and send it in through: https://api.youcanbook.me/v1/bookings/xxx then, take the pageId and send that on the query string as both fromBookingId AND bookingPageIds, and the best i get is like 50 returns that sometimes have my appointment in it???
for some reason i have to have a from value?? but from what? the documents just say Start date of the time range” WHAT TIME RANGE?? I just want to query a single appointment!! you have bookingPageIds, which says its an array of bookingIds, but no example of how to format an array in a url param.. so thats useless, searchTextCriteria says “list of booking fields to be compared with the provided searchText, but once again, no examples, or explanation as to how?? cant limit your search below 10 (pagination limit) how is ANYONE using this?? Please! for the love of all that is good in this world, someone show me how to find a single appointment and add/edit an appointment?? this shouldnt be this hard!
PS: please, whoever wrote your api, have them document how to use it, this api is seemingly excessively over complicated, so very heavy documentation is needed.
@Bob my apologies for the frustration. There are a few ways to get Booking data, the end point you mention v1/bookings/{bookingId or ref#} will give you the basic information. You can use the field control (?fields=answers,answers.string,answers.code,id,startsAt…) to get any specific information you are looking for. (All fields present here: GET Bookings Schema)
The booking query endpoint will give you all of the booking data available and allow you to pull up to 500 bookings at a time based off of the createdAt, startsAt, time range, and searching the form, or for a specific booker.
I will work this week on updating the documentation to make everything clearer, I appreciate your candor on that front. Feel free to send me a direct message and I help you work out anything specific to your workflow.