Added /discover to list of API endpoints and added documentation that the verification methods are returned in preferred order.
added more errors details, broke out certificate sign, changes in response to comments
Have the /verify endpoint return the client's MSISDN
Merge pull request #46 from ckarlof/ckarlof-api-change-proposal

Final API definition
Little changes from ckarlof proposal.