Add exception handling to directory servlet, so we don't 500. Mark directory API as volatile in the api docs.

apidocs: Tweak join response format. Explicitly state empty JSON objects where they are required by the spec. Mark unimplemented room GET APIs clearly.