merchant_api_delete-private-units-UNIT.c (5670B)
1 /* 2 This file is part of TALER 3 Copyright (C) 2025-2026 Taler Systems SA 4 5 TALER is free software; you can redistribute it and/or modify it under the 6 terms of the GNU Lesser General Public License as published by the Free Software 7 Foundation; either version 2.1, or (at your option) any later version. 8 9 TALER is distributed in the hope that it will be useful, but WITHOUT ANY 10 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR 11 A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. 12 13 You should have received a copy of the GNU Lesser General Public License along with 14 TALER; see the file COPYING.LGPL. If not, see 15 <http://www.gnu.org/licenses/> 16 */ 17 /** 18 * @file merchant_api_delete-private-units-UNIT-new.c 19 * @brief Implementation of the DELETE /private/units/$UNIT request 20 * @author Christian Grothoff 21 */ 22 #include "taler/platform.h" 23 #include <curl/curl.h> 24 #include <jansson.h> 25 #include <microhttpd.h> /* just for HTTP status codes */ 26 #include <gnunet/gnunet_util_lib.h> 27 #include <gnunet/gnunet_curl_lib.h> 28 #include <taler/taler-merchant/delete-private-units-UNIT.h> 29 #include "merchant_api_curl_defaults.h" 30 #include <taler/taler_json_lib.h> 31 32 33 /** 34 * Handle for a DELETE /private/units/$UNIT operation. 35 */ 36 struct TALER_MERCHANT_DeletePrivateUnitHandle 37 { 38 /** 39 * Base URL of the merchant backend. 40 */ 41 char *base_url; 42 43 /** 44 * The full 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_DeletePrivateUnitCallback cb; 57 58 /** 59 * Closure for @a cb. 60 */ 61 TALER_MERCHANT_DELETE_PRIVATE_UNIT_RESULT_CLOSURE *cb_cls; 62 63 /** 64 * Reference to the execution context. 65 */ 66 struct GNUNET_CURL_Context *ctx; 67 68 /** 69 * Identifier of the unit to delete. 70 */ 71 char *unit_id; 72 }; 73 74 75 /** 76 * Function called when we're done processing the 77 * HTTP DELETE /private/units/$UNIT request. 78 * 79 * @param cls the `struct TALER_MERCHANT_DeletePrivateUnitHandle` 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_delete_unit_finished (void *cls, 85 long response_code, 86 const void *response) 87 { 88 struct TALER_MERCHANT_DeletePrivateUnitHandle *duh = cls; 89 const json_t *json = response; 90 struct TALER_MERCHANT_DeletePrivateUnitResponse dur = { 91 .hr.http_status = (unsigned int) response_code, 92 .hr.reply = json 93 }; 94 95 duh->job = NULL; 96 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, 97 "Got /private/units/$UNIT DELETE response with status code %u\n", 98 (unsigned int) response_code); 99 switch (response_code) 100 { 101 case MHD_HTTP_NO_CONTENT: 102 break; 103 case MHD_HTTP_UNAUTHORIZED: 104 dur.hr.ec = TALER_JSON_get_error_code (json); 105 dur.hr.hint = TALER_JSON_get_error_hint (json); 106 break; 107 case MHD_HTTP_NOT_FOUND: 108 dur.hr.ec = TALER_JSON_get_error_code (json); 109 dur.hr.hint = TALER_JSON_get_error_hint (json); 110 break; 111 case MHD_HTTP_CONFLICT: 112 dur.hr.ec = TALER_JSON_get_error_code (json); 113 dur.hr.hint = TALER_JSON_get_error_hint (json); 114 break; 115 default: 116 dur.hr.ec = TALER_JSON_get_error_code (json); 117 dur.hr.hint = TALER_JSON_get_error_hint (json); 118 GNUNET_log (GNUNET_ERROR_TYPE_ERROR, 119 "Unexpected response code %u/%d for DELETE /private/units/$UNIT\n", 120 (unsigned int) response_code, 121 (int) dur.hr.ec); 122 break; 123 } 124 duh->cb (duh->cb_cls, 125 &dur); 126 TALER_MERCHANT_delete_private_unit_cancel (duh); 127 } 128 129 130 struct TALER_MERCHANT_DeletePrivateUnitHandle * 131 TALER_MERCHANT_delete_private_unit_create ( 132 struct GNUNET_CURL_Context *ctx, 133 const char *url, 134 const char *unit_id) 135 { 136 struct TALER_MERCHANT_DeletePrivateUnitHandle *duh; 137 138 duh = GNUNET_new (struct TALER_MERCHANT_DeletePrivateUnitHandle); 139 duh->ctx = ctx; 140 duh->base_url = GNUNET_strdup (url); 141 duh->unit_id = GNUNET_strdup (unit_id); 142 return duh; 143 } 144 145 146 enum TALER_ErrorCode 147 TALER_MERCHANT_delete_private_unit_start ( 148 struct TALER_MERCHANT_DeletePrivateUnitHandle *duh, 149 TALER_MERCHANT_DeletePrivateUnitCallback cb, 150 TALER_MERCHANT_DELETE_PRIVATE_UNIT_RESULT_CLOSURE *cb_cls) 151 { 152 CURL *eh; 153 154 duh->cb = cb; 155 duh->cb_cls = cb_cls; 156 { 157 char *path; 158 159 GNUNET_asprintf (&path, 160 "private/units/%s", 161 duh->unit_id); 162 duh->url = TALER_url_join (duh->base_url, 163 path, 164 NULL); 165 GNUNET_free (path); 166 } 167 if (NULL == duh->url) 168 return TALER_EC_GENERIC_CONFIGURATION_INVALID; 169 eh = TALER_MERCHANT_curl_easy_get_ (duh->url); 170 if (NULL == eh) 171 return TALER_EC_GENERIC_CONFIGURATION_INVALID; 172 GNUNET_assert (CURLE_OK == 173 curl_easy_setopt (eh, 174 CURLOPT_CUSTOMREQUEST, 175 MHD_HTTP_METHOD_DELETE)); 176 duh->job = GNUNET_CURL_job_add (duh->ctx, 177 eh, 178 &handle_delete_unit_finished, 179 duh); 180 if (NULL == duh->job) 181 return TALER_EC_GENERIC_INTERNAL_INVARIANT_FAILURE; 182 return TALER_EC_NONE; 183 } 184 185 186 void 187 TALER_MERCHANT_delete_private_unit_cancel ( 188 struct TALER_MERCHANT_DeletePrivateUnitHandle *duh) 189 { 190 if (NULL != duh->job) 191 { 192 GNUNET_CURL_job_cancel (duh->job); 193 duh->job = NULL; 194 } 195 GNUNET_free (duh->url); 196 GNUNET_free (duh->unit_id); 197 GNUNET_free (duh->base_url); 198 GNUNET_free (duh); 199 } 200 201 202 /* end of merchant_api_delete-private-units-UNIT-new.c */