new version of the candidate api blueprint, can be seen at http://docs.candidateapi.apiary.io/