soup-status: libsoup Reference Manual

## soup-status soup-status — HTTP (and libsoup) status codes |

## Functions

#define | SOUP_STATUS_IS_TRANSPORT_ERROR()
#define | SOUP_STATUS_IS_INFORMATIONAL()
#define | SOUP_STATUS_IS_SUCCESSFUL()
#define | SOUP_STATUS_IS_REDIRECTION()
#define | SOUP_STATUS_IS_CLIENT_ERROR()
#define | SOUP_STATUS_IS_SERVER_ERROR()
const char * | soup_status_get_phrase ()
guint | soup_status_proxify ()

## Types and Values

enum | SoupStatus
#define | SOUP_HTTP_ERROR

## Includes

    #include <libsoup/soup.h>

## Description

## Functions

### SOUP_STATUS_IS_TRANSPORT_ERROR()

    #define SOUP_STATUS_IS_TRANSPORT_ERROR(status) ((status) >  0   && (status) < 100)

Tests if `status` is a libsoup transport error.

#### Parameters

status | a status code |

#### Returns

`TRUE` or `FALSE`

### SOUP_STATUS_IS_INFORMATIONAL()

    #define SOUP_STATUS_IS_INFORMATIONAL(status)   ((status) >= 100 && (status) < 200)

Tests if `status` is an Informational (1xx) response.

#### Parameters

status | an HTTP status code |

#### Returns

`TRUE` or `FALSE`

### SOUP_STATUS_IS_SUCCESSFUL()

    #define SOUP_STATUS_IS_SUCCESSFUL(status)      ((status) >= 200 && (status) < 300)

Tests if `status` is a Successful (2xx) response.

#### Parameters

status | an HTTP status code |

#### Returns

`TRUE` or `FALSE`

### SOUP_STATUS_IS_REDIRECTION()

    #define SOUP_STATUS_IS_REDIRECTION(status)     ((status) >= 300 && (status) < 400)

Tests if `status` is a Redirection (3xx) response.

#### Parameters

status | an HTTP status code |

#### Returns

`TRUE` or `FALSE`

### SOUP_STATUS_IS_CLIENT_ERROR()

    #define SOUP_STATUS_IS_CLIENT_ERROR(status)    ((status) >= 400 && (status) < 500)

Tests if `status` is a Client Error (4xx) response.

#### Parameters

status | an HTTP status code |

#### Returns

`TRUE` or `FALSE`

### SOUP_STATUS_IS_SERVER_ERROR()

    #define SOUP_STATUS_IS_SERVER_ERROR(status)    ((status) >= 500 && (status) < 600)

Tests if `status` is a Server Error (5xx) response.

#### Parameters

status | an HTTP status code |

#### Returns

`TRUE` or `FALSE`

### soup_status_get_phrase ()

    const char *
    soup_status_get_phrase (guint status_code);

Looks up the stock HTTP description of `status_code` . This is used by `soup_message_set_status()` to get the correct text to go with a given status code.

There is no reason for you to ever use this function. If you wanted the textual description for the “status_code” of a given SoupMessage, you should just look at the message's “reason_phrase”. However, you should only do that for use in debugging messages; HTTP reason phrases are not localized, and are not generally very descriptive anyway, and so they should never be presented to the user directly. Instead, you should create you own error messages based on the status code, and on what you were trying to do.

#### Parameters

status_code | an HTTP status code |

#### Returns

the (terse, English) description of `status_code`

### soup_status_proxify ()

    guint
    soup_status_proxify (guint status_code);

Turns `SOUP_STATUS_CANT_RESOLVE` into `SOUP_STATUS_CANT_RESOLVE_PROXY` and `SOUP_STATUS_CANT_CONNECT` into `SOUP_STATUS_CANT_CONNECT_PROXY`. Other status codes are passed through unchanged.

#### Parameters

status_code | a status code |

#### Returns

the "proxified" equivalent of `status_code` .

Since: 2.26

## Types and Values

### enum SoupStatus

These represent the known HTTP status code values, plus various network and internal errors.

Note that no libsoup functions take or return this type directly; any function that works with status codes will accept unrecognized status codes as well.

Prior to 2.44 this type was called `SoupKnownStatusCode`, but the individual values have always had the names they have now.

#### Members

SOUP_STATUS_NONE | No status available. (Eg, the message has not been sent yet) |
SOUP_STATUS_CANCELLED | Message was cancelled locally |
SOUP_STATUS_CANT_RESOLVE | Unable to resolve destination host name |
SOUP_STATUS_CANT_RESOLVE_PROXY | Unable to resolve proxy host name |
SOUP_STATUS_CANT_CONNECT | Unable to connect to remote host |
SOUP_STATUS_CANT_CONNECT_PROXY | Unable to connect to proxy |
SOUP_STATUS_SSL_FAILED | SSL/TLS negotiation failed |
SOUP_STATUS_IO_ERROR | A network error occurred, or the other end closed the connection unexpectedly |
SOUP_STATUS_MALFORMED | Malformed data (usually a programmer error) |
SOUP_STATUS_TRY_AGAIN | Used internally |
SOUP_STATUS_TOO_MANY_REDIRECTS | There were too many redirections |
SOUP_STATUS_TLS_FAILED | Used internally |
SOUP_STATUS_CONTINUE | 100 Continue (HTTP) |
SOUP_STATUS_SWITCHING_PROTOCOLS | 101 Switching Protocols (HTTP) |
SOUP_STATUS_PROCESSING | 102 Processing (WebDAV) |
SOUP_STATUS_OK | 200 Success (HTTP). Also used by many lower-level soup routines to indicate success. |
SOUP_STATUS_CREATED | 201 Created (HTTP) |
SOUP_STATUS_ACCEPTED | 202 Accepted (HTTP) |
SOUP_STATUS_NON_AUTHORITATIVE | 203 Non-Authoritative Information (HTTP) |
SOUP_STATUS_NO_CONTENT | 204 No Content (HTTP) |
SOUP_STATUS_RESET_CONTENT | 205 Reset Content (HTTP) |
SOUP_STATUS_PARTIAL_CONTENT | 206 Partial Content (HTTP) |
SOUP_STATUS_MULTI_STATUS | 207 Multi-Status (WebDAV) |
SOUP_STATUS_MULTIPLE_CHOICES | 300 Multiple Choices (HTTP) |
SOUP_STATUS_MOVED_PERMANENTLY | 301 Moved Permanently (HTTP) |
SOUP_STATUS_FOUND | 302 Found (HTTP) |
SOUP_STATUS_MOVED_TEMPORARILY | 302 Moved Temporarily (old name, RFC 2068) |
SOUP_STATUS_SEE_OTHER | 303 See Other (HTTP) |
SOUP_STATUS_NOT_MODIFIED | 304 Not Modified (HTTP) |
SOUP_STATUS_USE_PROXY | 305 Use Proxy (HTTP) |
SOUP_STATUS_NOT_APPEARING_IN_THIS_PROTOCOL | 306 [Unused] (HTTP) |
SOUP_STATUS_TEMPORARY_REDIRECT | 307 Temporary Redirect (HTTP) |
SOUP_STATUS_BAD_REQUEST | 400 Bad Request (HTTP) |
SOUP_STATUS_UNAUTHORIZED | 401 Unauthorized (HTTP) |
SOUP_STATUS_PAYMENT_REQUIRED | 402 Payment Required (HTTP) |
SOUP_STATUS_FORBIDDEN | 403 Forbidden (HTTP) |
SOUP_STATUS_NOT_FOUND | 404 Not Found (HTTP) |
SOUP_STATUS_METHOD_NOT_ALLOWED | 405 Method Not Allowed (HTTP) |
SOUP_STATUS_NOT_ACCEPTABLE | 406 Not Acceptable (HTTP) |
SOUP_STATUS_PROXY_AUTHENTICATION_REQUIRED | 407 Proxy Authentication Required (HTTP) |
SOUP_STATUS_PROXY_UNAUTHORIZED | shorter alias for `SOUP_STATUS_PROXY_AUTHENTICATION_REQUIRED` |
SOUP_STATUS_REQUEST_TIMEOUT | 408 Request Timeout (HTTP) |
SOUP_STATUS_CONFLICT | 409 Conflict (HTTP) |
SOUP_STATUS_GONE | 410 Gone (HTTP) |
SOUP_STATUS_LENGTH_REQUIRED | 411 Length Required (HTTP) |
SOUP_STATUS_PRECONDITION_FAILED | 412 Precondition Failed (HTTP) |
SOUP_STATUS_REQUEST_ENTITY_TOO_LARGE | 413 Request Entity Too Large (HTTP) |
SOUP_STATUS_REQUEST_URI_TOO_LONG | 414 Request-URI Too Long (HTTP) |
SOUP_STATUS_UNSUPPORTED_MEDIA_TYPE | 415 Unsupported Media Type (HTTP) |
SOUP_STATUS_REQUESTED_RANGE_NOT_SATISFIABLE | 416 Requested Range Not Satisfiable (HTTP) |
SOUP_STATUS_INVALID_RANGE | shorter alias for `SOUP_STATUS_REQUESTED_RANGE_NOT_SATISFIABLE` |
SOUP_STATUS_EXPECTATION_FAILED | 417 Expectation Failed (HTTP) |
SOUP_STATUS_UNPROCESSABLE_ENTITY | 422 Unprocessable Entity (WebDAV) |
SOUP_STATUS_LOCKED | 423 Locked (WebDAV) |
SOUP_STATUS_FAILED_DEPENDENCY | 424 Failed Dependency (WebDAV) |
SOUP_STATUS_INTERNAL_SERVER_ERROR | 500 Internal Server Error (HTTP) |
SOUP_STATUS_NOT_IMPLEMENTED | 501 Not Implemented (HTTP) |
SOUP_STATUS_BAD_GATEWAY | 502 Bad Gateway (HTTP) |
SOUP_STATUS_SERVICE_UNAVAILABLE | 503 Service Unavailable (HTTP) |
SOUP_STATUS_GATEWAY_TIMEOUT | 504 Gateway Timeout (HTTP) |
SOUP_STATUS_HTTP_VERSION_NOT_SUPPORTED | 505 HTTP Version Not Supported (HTTP) |
SOUP_STATUS_INSUFFICIENT_STORAGE | 507 Insufficient Storage (WebDAV) |
SOUP_STATUS_NOT_EXTENDED | 510 Not Extended (RFC 2774) |

### SOUP_HTTP_ERROR

    #define SOUP_HTTP_ERROR soup_http_error_quark()

A GError domain representing an HTTP status. Use a SoupStatus for the `code` value.