summaryrefslogtreecommitdiff
path: root/icclient/client.h
blob: 5e0f01b10ffe3a3d9404f053b92884a549899248 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
#ifndef ICCLIENT_CLIENT_H
#define ICCLIENT_CLIENT_H

#define	icclient_allproducts(callback, catalog, handler) icclient_results("All-Products", callback, catalog, handler)

struct icclient_product;
struct icclient_catalog;

#ifdef __cplusplus
extern "C" {
#endif

	/*!
	 * \brief A function that needs to be run first.
	 * \param url Server root URL.
	 * \param certificate Path to the CA certificate file.
	 * \return True if the initialisation works, false otherwise.
	 */
	bool icclient_init(const char *url, const char *certificate);

	/*!
	 * \brief For fetching data about products that belong a specific group.
	 * \param prod_group The name of the product group.
	 * \param callback A pointer to the function that needs to be called after the catalog is ready.
	 * \param catalog A pointer to pointer to the catalog to store the data.
	 * \param handler A pointer to the function when a custom handler is needed to arrange the data into the catalog.
	 */
	void icclient_results(const char *prod_group, void (*callback)(struct icclient_catalog *),
			struct icclient_catalog **catalog, icclient_handler handler);

	/*!
	 * \brief For fetching data about a specific product.
	 * \param sku The SKU of the product.
	 * \param handler A pointer to a cURL write function callback.
	 * \param productptr A pointer to pointer to the product to store the data.
	 */
	void icclient_flypage(const char *sku, icclient_handler handler, struct icclient_product **productptr);

	void icclient_page(const char *path, icclient_handler handler, void **dataptr);
	void icclient_cleanup();

#ifdef __cplusplus
}
#endif

#endif