Error Model

Like everything else in OPML, error handling is very simple. Unless something is wrong on our end, you will only ever receive one of two HTTP status codes – 200 OK or 403 Forbidden. The latter should only occur if you attempt an operation that is restricted by partner or account.

The “real” response codes will be found in the OPML header. The status element represents the result of the call. It will have familiar-looking HTTP status values like 200, 400, 401, or 500. In the event of a client or server error (400/500 series), the <fault> element will have textual detail describing the problem. Moreover, the <fault_code> element will contain a consistent key that may be used to take appropriate action (fault text might change, but codes will remain constant).