Die IETF hat einen Standard für API-Fehlermeldungen: http://tools.ietf.org/html/draft-nottingham-http-problem-03 - hier ist eine PHP-Implementierung https://github.com/Crell/ApiProblem