merchant_api_post_templates.c (8150B)
1 /* 2 This file is part of TALER 3 Copyright (C) 2022 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 merchant_api_post_templates.c 21 * @brief Implementation of the POST /templates request 22 * of the merchant's HTTP API 23 * @author Priscilla HUANG 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 "merchant_api_curl_defaults.h" 32 #include "merchant_api_common.h" 33 #include <taler/taler_json_lib.h> 34 #include <taler/taler_curl_lib.h> 35 36 37 /** 38 * Handle for a POST /templates/$ID operation. 39 */ 40 struct TALER_MERCHANT_TemplatesPostHandle 41 { 42 43 /** 44 * The url for this request. 45 */ 46 char *url; 47 48 /** 49 * Handle for the request. 50 */ 51 struct GNUNET_CURL_Job *job; 52 53 /** 54 * Function to call with the result. 55 */ 56 TALER_MERCHANT_TemplatesPostCallback cb; 57 58 /** 59 * Closure for @a cb. 60 */ 61 void *cb_cls; 62 63 /** 64 * Reference to the execution context. 65 */ 66 struct GNUNET_CURL_Context *ctx; 67 68 /** 69 * Minor context that holds body and headers. 70 */ 71 struct TALER_CURL_PostContext post_ctx; 72 }; 73 74 75 /** 76 * Function called when we're done processing the 77 * HTTP POST /templates request. 78 * 79 * @param cls the `struct TALER_MERCHANT_TemplatesPostHandle` 80 * @param response_code HTTP response code, 0 on error 81 * @param response response body, NULL if not in JSON 82 */ 83 static void 84 handle_post_templates_finished (void *cls, 85 long response_code, 86 const void *response) 87 { 88 struct TALER_MERCHANT_TemplatesPostHandle *tph = cls; 89 const json_t *json = response; 90 struct TALER_MERCHANT_HttpResponse hr = { 91 .http_status = (unsigned int) response_code, 92 .reply = json 93 }; 94 95 tph->job = NULL; 96 GNUNET_log (GNUNET_ERROR_TYPE_INFO, 97 "POST /templates completed with response code %u\n", 98 (unsigned int) response_code); 99 switch (response_code) 100 { 101 case 0: 102 hr.ec = TALER_EC_GENERIC_INVALID_RESPONSE; 103 break; 104 case MHD_HTTP_NO_CONTENT: 105 break; 106 case MHD_HTTP_BAD_REQUEST: 107 hr.ec = TALER_JSON_get_error_code (json); 108 hr.hint = TALER_JSON_get_error_hint (json); 109 /* This should never happen, either us 110 * or the merchant is buggy (or API version conflict); 111 * just pass JSON reply to the application */ 112 break; 113 case MHD_HTTP_UNAUTHORIZED: 114 hr.ec = TALER_JSON_get_error_code (json); 115 hr.hint = TALER_JSON_get_error_hint (json); 116 /* Nothing really to verify, merchant says we need to authenticate. */ 117 break; 118 case MHD_HTTP_FORBIDDEN: 119 hr.ec = TALER_JSON_get_error_code (json); 120 hr.hint = TALER_JSON_get_error_hint (json); 121 /* Nothing really to verify, merchant says we tried to abort the payment 122 * after it was successful. We should pass the JSON reply to the 123 * application */ 124 break; 125 case MHD_HTTP_NOT_FOUND: 126 hr.ec = TALER_JSON_get_error_code (json); 127 hr.hint = TALER_JSON_get_error_hint (json); 128 /* Nothing really to verify, this should never 129 happen, we should pass the JSON reply to the 130 application */ 131 break; 132 case MHD_HTTP_CONFLICT: 133 hr.ec = TALER_JSON_get_error_code (json); 134 hr.hint = TALER_JSON_get_error_hint (json); 135 break; 136 case MHD_HTTP_INTERNAL_SERVER_ERROR: 137 hr.ec = TALER_JSON_get_error_code (json); 138 hr.hint = TALER_JSON_get_error_hint (json); 139 /* Server had an internal issue; we should retry, 140 but this API leaves this to the application */ 141 break; 142 default: 143 TALER_MERCHANT_parse_error_details_ (json, 144 response_code, 145 &hr); 146 /* unexpected response code */ 147 GNUNET_log (GNUNET_ERROR_TYPE_ERROR, 148 "Unexpected response code %u/%d\n", 149 (unsigned int) response_code, 150 (int) hr.ec); 151 GNUNET_break_op (0); 152 break; 153 } 154 tph->cb (tph->cb_cls, 155 &hr); 156 TALER_MERCHANT_templates_post_cancel (tph); 157 } 158 159 160 static bool 161 test_template_contract_valid (const json_t *template_contract) 162 { 163 const char *summary; 164 struct TALER_Amount amount = { .value = 0}; 165 uint32_t minimum_age = 0; 166 struct GNUNET_TIME_Relative pay_duration = { 0 }; 167 struct GNUNET_JSON_Specification spec[] = { 168 GNUNET_JSON_spec_mark_optional ( 169 GNUNET_JSON_spec_string ("summary", 170 &summary), 171 NULL), 172 GNUNET_JSON_spec_mark_optional ( 173 TALER_JSON_spec_amount_any ("amount", 174 &amount), 175 NULL), 176 GNUNET_JSON_spec_uint32 ("minimum_age", 177 &minimum_age), 178 GNUNET_JSON_spec_relative_time ("pay_duration", 179 &pay_duration), 180 GNUNET_JSON_spec_end () 181 }; 182 const char *ename; 183 unsigned int eline; 184 185 if (GNUNET_OK != 186 GNUNET_JSON_parse (template_contract, 187 spec, 188 &ename, 189 &eline)) 190 { 191 GNUNET_log (GNUNET_ERROR_TYPE_WARNING, 192 "Invalid template_contract for field %s\n", 193 ename); 194 return false; 195 } 196 return true; 197 } 198 199 200 struct TALER_MERCHANT_TemplatesPostHandle * 201 TALER_MERCHANT_templates_post ( 202 struct GNUNET_CURL_Context *ctx, 203 const char *backend_url, 204 const char *template_id, 205 const char *template_description, 206 const char *otp_id, 207 const json_t *template_contract, 208 TALER_MERCHANT_TemplatesPostCallback cb, 209 void *cb_cls) 210 { 211 struct TALER_MERCHANT_TemplatesPostHandle *tph; 212 json_t *req_obj; 213 214 if (! test_template_contract_valid (template_contract)) 215 { 216 GNUNET_break (0); 217 return NULL; 218 } 219 req_obj = GNUNET_JSON_PACK ( 220 GNUNET_JSON_pack_string ("template_id", 221 template_id), 222 GNUNET_JSON_pack_string ("template_description", 223 template_description), 224 GNUNET_JSON_pack_allow_null ( 225 GNUNET_JSON_pack_string ("otp_id", 226 otp_id)), 227 GNUNET_JSON_pack_object_incref ("template_contract", 228 (json_t *) template_contract)); 229 tph = GNUNET_new (struct TALER_MERCHANT_TemplatesPostHandle); 230 tph->ctx = ctx; 231 tph->cb = cb; 232 tph->cb_cls = cb_cls; 233 tph->url = TALER_url_join (backend_url, 234 "private/templates", 235 NULL); 236 if (NULL == tph->url) 237 { 238 GNUNET_log (GNUNET_ERROR_TYPE_ERROR, 239 "Could not construct request URL.\n"); 240 json_decref (req_obj); 241 GNUNET_free (tph); 242 return NULL; 243 } 244 { 245 CURL *eh; 246 247 eh = TALER_MERCHANT_curl_easy_get_ (tph->url); 248 GNUNET_assert (GNUNET_OK == 249 TALER_curl_easy_post (&tph->post_ctx, 250 eh, 251 req_obj)); 252 json_decref (req_obj); 253 tph->job = GNUNET_CURL_job_add2 (ctx, 254 eh, 255 tph->post_ctx.headers, 256 &handle_post_templates_finished, 257 tph); 258 GNUNET_assert (NULL != tph->job); 259 } 260 return tph; 261 } 262 263 264 void 265 TALER_MERCHANT_templates_post_cancel ( 266 struct TALER_MERCHANT_TemplatesPostHandle *tph) 267 { 268 if (NULL != tph->job) 269 { 270 GNUNET_CURL_job_cancel (tph->job); 271 tph->job = NULL; 272 } 273 TALER_curl_easy_post_finished (&tph->post_ctx); 274 GNUNET_free (tph->url); 275 GNUNET_free (tph); 276 } 277 278 279 /* end of merchant_api_post_templates.c */