latest changes from apis.io validator
update on apis.json described in the spec + newly updated schema