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 body response body (@c NULL if request aborted)
43 * @param callback_data callback data
45 typedef void (sipe_http_response_callback
)(struct sipe_core_private
*sipe_private
,
48 gpointer callback_data
);
50 /* HTTP status codes */
51 #define SIPE_HTTP_STATUS_OK 200
56 * @param sipe_private SIPE core private data
58 void sipe_http_free(struct sipe_core_private
*sipe_private
);
63 * @return pointer to opaque HTTP session data structure
65 struct sipe_http_session
*sipe_http_session_start(void);
70 * @param session pointer to opaque HTTP session data structure
72 void sipe_http_session_close(struct sipe_http_session
*session
);
75 * Create HTTP GET request
77 * @param sipe_private SIPE core private data
79 * @param headers additional headers (may be @c NULL)
81 * @return pointer to opaque HTTP request data structure (@c NULL if failed)
83 struct sipe_http_request
*sipe_http_request_get(struct sipe_core_private
*sipe_private
,
86 sipe_http_response_callback
*callback
,
87 gpointer callback_data
);
90 * Create HTTP POST request
92 * @param sipe_private SIPE core private data
94 * @param headers additional headers (may be @c NULL)
95 * @param body body contents
96 * @param content_type body content type
98 * @return pointer to opaque HTTP request data structure (@c NULL if failed)
100 struct sipe_http_request
*sipe_http_request_post(struct sipe_core_private
*sipe_private
,
102 const gchar
*headers
,
104 const gchar
*content_type
,
105 sipe_http_response_callback
*callback
,
106 gpointer callback_data
);
109 * Cancel pending HTTP request
111 * @param pointer to opaque HTTP request data structure
113 void sipe_http_request_cancel(struct sipe_http_request
*request
);
116 * Assign request to HTTP session
118 * @param request pointer to opaque HTTP request data structure
119 * @param session pointer to opaque HTTP session data structure
121 void sipe_http_request_session(struct sipe_http_request
*request
,
122 const struct sipe_http_session
*session
);