HTTP

Funciones

Http*	http_create (...)
void	http_destroy (...)
void	http_param (...)
void	http_header (...)
void	http_clear_params (...)
void	http_clear_headers (...)
void	http_get (...)
Stream*	http_dget (...)

http_create ()

Crea un objeto HTTP para realizar peticiones a un servidor.

Http*
http_create(const char_t *host,
            const uint16_t port,
            ierror_t *error);

host	Nombre del servidor.
port	Puerto de conexión.
error	Código de error si la función falla. Puede ser `NULL`.

Retorna

Objeto recién creado.

http_destroy ()

Destruye un objeto HTTP.

void
http_destroy(Http **http);

http	El objeto HTTP. Será puesto a `NULL` tras la destrucción.

http_param ()

Añade un parámetro a la petición HTTP.

void
http_param(Http *http,
           const char_t *name,
           const char_t *value);

http	El objeto HTTP.
name	El nombre del parámetro.
value	El valor del parámetro.

http_header ()

Añade una cabecera a la petición HTTP.

void
http_header(Http *http,
            const char_t *name,
            const char_t *value);

http	El objeto HTTP.
name	El nombre de la cabecera.
value	El valor de la cabecera.

http_clear_params ()

Elimina los parámetros previamente asignados.

void
http_clear_params(Http *http);

http	El objeto HTTP.

http_clear_headers ()

Elimina las cabeceras previamente asignadas.

void
http_clear_headers(Http *http);

http	El objeto HTTP.

http_get ()

Realiza una petición HTTP.

void
http_get(Http *http,
         const char_t *uri,
         Stream *body,
         ierror_t *error);

http	El objeto HTTP.
uri	Dirección del recurso.
body	Stream de escritura donde se guardará la respuesta.
error	Código de error si la función falla. Puede ser `NULL`.

http_dget ()

Realiza una petición HTTP de un recurso Web.

Stream*
http_dget(const char_t *host,
          const uint16_t port,
          const char_t *uri,
          ierror_t *error);

1 2	// http://serv.nappgui.com:80/dproducts.php Stream *json = http_dget("serv.nappgui.com", 80, "/dproducts.php", &error);

host	Nombre del servidor.
port	Puerto de conexión.
uri	Dirección del recurso.
error	Código de error si la función falla. Puede ser `NULL`.

Retorna

Stream de lectura con el resultado de la petición. La aplicación debe conocer como de-serializar el contenido.

Observaciones

Utiliza esta función para el acceso directo a un recurso aislado. Si necesitas realizar varias peticiones o configurar las cabeceras y parámetros, utiliza http_create.