Line data Source code
1 : /*
2 : This file is part of TALER
3 : Copyright (C) 2020 Taler Systems SA
4 :
5 : TALER is free software; you can redistribute it and/or modify
6 : it under the terms of the GNU Lesser General Public License as
7 : published by the Free Software Foundation; either version 2.1,
8 : or (at your option) any later version.
9 :
10 : TALER is distributed in the hope that it will be useful,
11 : but WITHOUT ANY WARRANTY; without even the implied warranty of
12 : MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 : GNU Lesser General Public License for more details.
14 :
15 : You should have received a copy of the GNU Lesser General
16 : Public License along with TALER; see the file COPYING.LGPL.
17 : If not, see <http://www.gnu.org/licenses/>
18 : */
19 : /**
20 : * @file lib/merchant_api_post_products.c
21 : * @brief Implementation of the POST /products request
22 : * of the merchant's HTTP API
23 : * @author Christian Grothoff
24 : */
25 : #include "platform.h"
26 : #include <curl/curl.h>
27 : #include <jansson.h>
28 : #include <microhttpd.h> /* just for HTTP status codes */
29 : #include <gnunet/gnunet_util_lib.h>
30 : #include "taler_merchant_service.h"
31 : #include <taler/taler_json_lib.h>
32 : #include <taler/taler_curl_lib.h>
33 :
34 :
35 : /**
36 : * Handle for a POST /products/$ID operation.
37 : */
38 : struct TALER_MERCHANT_ProductsPostHandle
39 : {
40 :
41 : /**
42 : * The url for this request.
43 : */
44 : char *url;
45 :
46 : /**
47 : * Handle for the request.
48 : */
49 : struct GNUNET_CURL_Job *job;
50 :
51 : /**
52 : * Function to call with the result.
53 : */
54 : TALER_MERCHANT_ProductsPostCallback cb;
55 :
56 : /**
57 : * Closure for @a cb.
58 : */
59 : void *cb_cls;
60 :
61 : /**
62 : * Reference to the execution context.
63 : */
64 : struct GNUNET_CURL_Context *ctx;
65 :
66 : /**
67 : * Minor context that holds body and headers.
68 : */
69 : struct TALER_CURL_PostContext post_ctx;
70 :
71 : };
72 :
73 :
74 : /**
75 : * Function called when we're done processing the
76 : * HTTP POST /products request.
77 : *
78 : * @param cls the `struct TALER_MERCHANT_ProductsPostHandle`
79 : * @param response_code HTTP response code, 0 on error
80 : * @param json response body, NULL if not in JSON
81 : */
82 : static void
83 0 : handle_post_products_finished (void *cls,
84 : long response_code,
85 : const void *response)
86 : {
87 0 : struct TALER_MERCHANT_ProductsPostHandle *pph = cls;
88 0 : const json_t *json = response;
89 0 : struct TALER_MERCHANT_HttpResponse hr = {
90 0 : .http_status = (unsigned int) response_code,
91 : .reply = json
92 : };
93 :
94 0 : pph->job = NULL;
95 0 : GNUNET_log (GNUNET_ERROR_TYPE_INFO,
96 : "POST /products completed with response code %u\n",
97 : (unsigned int) response_code);
98 0 : switch (response_code)
99 : {
100 0 : case 0:
101 0 : hr.ec = TALER_EC_INVALID_RESPONSE;
102 0 : break;
103 0 : case MHD_HTTP_NO_CONTENT:
104 0 : break;
105 0 : case MHD_HTTP_BAD_REQUEST:
106 0 : hr.ec = TALER_JSON_get_error_code (json);
107 0 : hr.hint = TALER_JSON_get_error_hint (json);
108 : /* This should never happen, either us
109 : * or the merchant is buggy (or API version conflict);
110 : * just pass JSON reply to the application */
111 0 : break;
112 0 : case MHD_HTTP_FORBIDDEN:
113 0 : hr.ec = TALER_JSON_get_error_code (json);
114 0 : hr.hint = TALER_JSON_get_error_hint (json);
115 : /* Nothing really to verify, merchant says we tried to abort the payment
116 : * after it was successful. We should pass the JSON reply to the
117 : * application */
118 0 : break;
119 0 : case MHD_HTTP_NOT_FOUND:
120 0 : hr.ec = TALER_JSON_get_error_code (json);
121 0 : hr.hint = TALER_JSON_get_error_hint (json);
122 : /* Nothing really to verify, this should never
123 : happen, we should pass the JSON reply to the
124 : application */
125 0 : break;
126 0 : case MHD_HTTP_CONFLICT:
127 0 : hr.ec = TALER_JSON_get_error_code (json);
128 0 : hr.hint = TALER_JSON_get_error_hint (json);
129 0 : break;
130 0 : case MHD_HTTP_INTERNAL_SERVER_ERROR:
131 0 : hr.ec = TALER_JSON_get_error_code (json);
132 0 : hr.hint = TALER_JSON_get_error_hint (json);
133 : /* Server had an internal issue; we should retry,
134 : but this API leaves this to the application */
135 0 : break;
136 0 : default:
137 0 : TALER_MERCHANT_parse_error_details_ (json,
138 : response_code,
139 : &hr);
140 : /* unexpected response code */
141 0 : GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
142 : "Unexpected response code %u/%d\n",
143 : (unsigned int) response_code,
144 : (int) hr.ec);
145 0 : GNUNET_break_op (0);
146 0 : break;
147 : }
148 0 : pph->cb (pph->cb_cls,
149 : &hr);
150 0 : TALER_MERCHANT_products_post_cancel (pph);
151 0 : }
152 :
153 :
154 : /**
155 : * Make a POST /products request to add a product to the
156 : * inventory.
157 : *
158 : * @param ctx the context
159 : * @param backend_url HTTP base URL for the backend
160 : * @param product_id identifier to use for the product
161 : * @param description description of the product
162 : * @param description_i18n Map from IETF BCP 47 language tags to localized descriptions
163 : * @param unit unit in which the product is measured (liters, kilograms, packages, etc.)
164 : * @param price the price for one @a unit of the product, zero is used to imply that
165 : * this product is not sold separately or that the price is not fixed and
166 : * must be supplied by the front-end. If non-zero, price must include
167 : * applicable taxes.
168 : * @param image base64-encoded product image
169 : * @param taxes list of taxes paid by the merchant
170 : * @param total_stock in @a units, -1 to indicate "infinite" (i.e. electronic books)
171 : * @param address where the product is in stock
172 : * @param next_restock when the next restocking is expected to happen, 0 for unknown,
173 : * #GNUNET_TIME_UNIT_FOREVER_ABS for 'never'.
174 : * @param cb function to call with the backend's result
175 : * @param cb_cls closure for @a cb
176 : * @return the request handle; NULL upon error
177 : */
178 : struct TALER_MERCHANT_ProductsPostHandle *
179 0 : TALER_MERCHANT_products_post (
180 : struct GNUNET_CURL_Context *ctx,
181 : const char *backend_url,
182 : const char *product_id,
183 : const char *description,
184 : const json_t *description_i18n,
185 : const char *unit,
186 : const struct TALER_Amount *price,
187 : const json_t *image,
188 : const json_t *taxes,
189 : int64_t total_stock,
190 : const json_t *address,
191 : struct GNUNET_TIME_Absolute next_restock,
192 : TALER_MERCHANT_ProductsPostCallback cb,
193 : void *cb_cls)
194 : {
195 : struct TALER_MERCHANT_ProductsPostHandle *pph;
196 : json_t *req_obj;
197 :
198 0 : (void) GNUNET_TIME_round_abs (&next_restock);
199 0 : req_obj = json_pack ("{s:s, s:s, s:O, s:s, s:o,"
200 : " s:O, s:O, s:I, s:O, s:o}",
201 : "product_id",
202 : product_id,
203 : "description",
204 : description,
205 : "description_i18n",
206 : description_i18n,
207 : "unit",
208 : unit,
209 : "price",
210 : TALER_JSON_from_amount (price),
211 : /* End of first group of 5 */
212 : "image",
213 : image,
214 : "taxes",
215 : taxes,
216 : "total_stock",
217 : (json_int_t) total_stock,
218 : "address",
219 : address,
220 : "next_restock",
221 : GNUNET_JSON_from_time_abs (next_restock));
222 0 : if (NULL == req_obj)
223 : {
224 0 : GNUNET_break (0);
225 0 : return NULL;
226 : }
227 0 : pph = GNUNET_new (struct TALER_MERCHANT_ProductsPostHandle);
228 0 : pph->ctx = ctx;
229 0 : pph->cb = cb;
230 0 : pph->cb_cls = cb_cls;
231 0 : pph->url = TALER_url_join (backend_url,
232 : "private/products",
233 : NULL);
234 0 : if (NULL == pph->url)
235 : {
236 0 : GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
237 : "Could not construct request URL.\n");
238 0 : json_decref (req_obj);
239 0 : GNUNET_free (pph);
240 0 : return NULL;
241 : }
242 : {
243 : CURL *eh;
244 :
245 0 : eh = curl_easy_init ();
246 0 : GNUNET_assert (NULL != eh);
247 0 : GNUNET_assert (GNUNET_OK ==
248 : TALER_curl_easy_post (&pph->post_ctx,
249 : eh,
250 : req_obj));
251 0 : json_decref (req_obj);
252 0 : GNUNET_assert (CURLE_OK == curl_easy_setopt (eh,
253 : CURLOPT_URL,
254 : pph->url));
255 0 : pph->job = GNUNET_CURL_job_add2 (ctx,
256 : eh,
257 0 : pph->post_ctx.headers,
258 : &handle_post_products_finished,
259 : pph);
260 0 : GNUNET_assert (NULL != pph->job);
261 : }
262 0 : return pph;
263 : }
264 :
265 :
266 : /**
267 : * Cancel /products request. Must not be called by clients after
268 : * the callback was invoked.
269 : *
270 : * @param igh request to cancel.
271 : */
272 : void
273 0 : TALER_MERCHANT_products_post_cancel (
274 : struct TALER_MERCHANT_ProductsPostHandle *pph)
275 : {
276 0 : if (NULL != pph->job)
277 : {
278 0 : GNUNET_CURL_job_cancel (pph->job);
279 0 : pph->job = NULL;
280 : }
281 0 : TALER_curl_easy_post_finished (&pph->post_ctx);
282 0 : GNUNET_free (pph->url);
283 0 : GNUNET_free (pph);
284 0 : }
285 :
286 :
287 : /* end of merchant_api_post_products.c */
|
