booking analysis API doc: API splitted in 5
booking analysis API doc: cleaning up explanations about period parameters