6 * Copyright (C) 2013 SIPE Project <http://sipe.sourceforge.net/>
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 /* Public interface to HTTP request service */
27 * Interface dependencies:
32 /* Forward declarations */
33 struct sipe_core_private
;
34 struct sipe_http_request
;
35 struct sipe_http_session
;
38 * HTTP response callback
40 * @param sipe_private SIPE core private data
41 * @param status status code
42 * @param headers response headers (@c NULL if request aborted)
43 * @param body response body (@c NULL if request aborted)
44 * @param callback_data callback data
46 typedef void (sipe_http_response_callback
)(struct sipe_core_private
*sipe_private
,
50 gpointer callback_data
);
52 /* HTTP response status codes */
53 #define SIPE_HTTP_STATUS_OK 200
58 * @param sipe_private SIPE core private data
60 void sipe_http_free(struct sipe_core_private
*sipe_private
);
65 * @return pointer to opaque HTTP session data structure
67 struct sipe_http_session
*sipe_http_session_start(void);
72 * @param session pointer to opaque HTTP session data structure
74 void sipe_http_session_close(struct sipe_http_session
*session
);
77 * Create HTTP GET request
79 * @param sipe_private SIPE core private data
81 * @param headers additional headers (may be @c NULL)
82 * @param callback callback function
83 * @param callback_data callback data
85 * @return pointer to opaque HTTP request data structure (@c NULL if failed)
87 struct sipe_http_request
*sipe_http_request_get(struct sipe_core_private
*sipe_private
,
90 sipe_http_response_callback
*callback
,
91 gpointer callback_data
);
94 * Create HTTP POST request
96 * @param sipe_private SIPE core private data
98 * @param headers additional headers (may be @c NULL)
99 * @param body body contents
100 * @param content_type body content type
101 * @param callback callback function
102 * @param callback_data callback data
104 * @return pointer to opaque HTTP request data structure (@c NULL if failed)
106 struct sipe_http_request
*sipe_http_request_post(struct sipe_core_private
*sipe_private
,
108 const gchar
*headers
,
110 const gchar
*content_type
,
111 sipe_http_response_callback
*callback
,
112 gpointer callback_data
);
115 * HTTP request is ready to be sent
117 * @param request pointer to opaque HTTP request data structure
119 void sipe_http_request_ready(struct sipe_http_request
*request
);
122 * Cancel pending HTTP request
124 * @param request pointer to opaque HTTP request data structure
126 void sipe_http_request_cancel(struct sipe_http_request
*request
);
129 * Assign request to HTTP session
131 * @param request pointer to opaque HTTP request data structure
132 * @param session pointer to opaque HTTP session data structure
134 void sipe_http_request_session(struct sipe_http_request
*request
,
135 struct sipe_http_session
*session
);
138 * Allow redirection of HTTP request
140 * @param request pointer to opaque HTTP request data structure
142 void sipe_http_request_allow_redirect(struct sipe_http_request
*request
);
145 * Provide authentication information for HTTP request
147 * @param request pointer to opaque HTTP request data structure
148 * @param domain domain name (MUST stay valid for duration of request!)
149 * @param user user name (MUST stay valid for duration of request!)
150 * @param password Password (MUST stay valid for duration of request!)
152 void sipe_http_request_authentication(struct sipe_http_request
*request
,
155 const gchar
*password
);