merchant_api_delete-private-token.c (5577B)
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-token.c 19 * @brief Implementation of the DELETE /private/token 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-token.h> 29 #include "merchant_api_curl_defaults.h" 30 #include <taler/taler_json_lib.h> 31 32 33 /** 34 * Handle for a DELETE /private/token operation. 35 */ 36 struct TALER_MERCHANT_DeletePrivateTokenHandle 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_DeletePrivateTokenCallback cb; 57 58 /** 59 * Closure for @a cb. 60 */ 61 TALER_MERCHANT_DELETE_PRIVATE_TOKEN_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 instance whose token to delete. 70 */ 71 char *instance_id; 72 }; 73 74 75 /** 76 * Function called when we're done processing the 77 * HTTP DELETE /private/token request. 78 * 79 * @param cls the `struct TALER_MERCHANT_DeletePrivateTokenHandle` 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_token_finished (void *cls, 85 long response_code, 86 const void *response) 87 { 88 struct TALER_MERCHANT_DeletePrivateTokenHandle *dth = cls; 89 const json_t *json = response; 90 struct TALER_MERCHANT_DeletePrivateTokenResponse dtr = { 91 .hr.http_status = (unsigned int) response_code, 92 .hr.reply = json 93 }; 94 95 dth->job = NULL; 96 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, 97 "Got DELETE /instances/$ID/private/token 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 dtr.hr.ec = TALER_JSON_get_error_code (json); 105 dtr.hr.hint = TALER_JSON_get_error_hint (json); 106 break; 107 case MHD_HTTP_NOT_FOUND: 108 dtr.hr.ec = TALER_JSON_get_error_code (json); 109 dtr.hr.hint = TALER_JSON_get_error_hint (json); 110 break; 111 default: 112 dtr.hr.ec = TALER_JSON_get_error_code (json); 113 dtr.hr.hint = TALER_JSON_get_error_hint (json); 114 GNUNET_log (GNUNET_ERROR_TYPE_ERROR, 115 "Unexpected response code %u/%d for DELETE /instances/$ID/private/token\n", 116 (unsigned int) response_code, 117 (int) dtr.hr.ec); 118 break; 119 } 120 dth->cb (dth->cb_cls, 121 &dtr); 122 TALER_MERCHANT_delete_private_token_cancel (dth); 123 } 124 125 126 struct TALER_MERCHANT_DeletePrivateTokenHandle * 127 TALER_MERCHANT_delete_private_token_create ( 128 struct GNUNET_CURL_Context *ctx, 129 const char *url, 130 const char *instance_id) 131 { 132 struct TALER_MERCHANT_DeletePrivateTokenHandle *dth; 133 134 dth = GNUNET_new (struct TALER_MERCHANT_DeletePrivateTokenHandle); 135 dth->ctx = ctx; 136 dth->base_url = GNUNET_strdup (url); 137 dth->instance_id = GNUNET_strdup (instance_id); 138 return dth; 139 } 140 141 142 enum TALER_ErrorCode 143 TALER_MERCHANT_delete_private_token_start ( 144 struct TALER_MERCHANT_DeletePrivateTokenHandle *dth, 145 TALER_MERCHANT_DeletePrivateTokenCallback cb, 146 TALER_MERCHANT_DELETE_PRIVATE_TOKEN_RESULT_CLOSURE *cb_cls) 147 { 148 CURL *eh; 149 150 dth->cb = cb; 151 dth->cb_cls = cb_cls; 152 { 153 char *path; 154 155 GNUNET_asprintf (&path, 156 "instances/%s/private/token", 157 dth->instance_id); 158 dth->url = TALER_url_join (dth->base_url, 159 path, 160 NULL); 161 GNUNET_free (path); 162 } 163 if (NULL == dth->url) 164 return TALER_EC_GENERIC_CONFIGURATION_INVALID; 165 eh = TALER_MERCHANT_curl_easy_get_ (dth->url); 166 if (NULL == eh) 167 return TALER_EC_GENERIC_CONFIGURATION_INVALID; 168 GNUNET_assert (CURLE_OK == 169 curl_easy_setopt (eh, 170 CURLOPT_CUSTOMREQUEST, 171 MHD_HTTP_METHOD_DELETE)); 172 dth->job = GNUNET_CURL_job_add (dth->ctx, 173 eh, 174 &handle_delete_token_finished, 175 dth); 176 if (NULL == dth->job) 177 return TALER_EC_GENERIC_INTERNAL_INVARIANT_FAILURE; 178 return TALER_EC_NONE; 179 } 180 181 182 void 183 TALER_MERCHANT_delete_private_token_cancel ( 184 struct TALER_MERCHANT_DeletePrivateTokenHandle *dth) 185 { 186 if (NULL != dth->job) 187 { 188 GNUNET_CURL_job_cancel (dth->job); 189 dth->job = NULL; 190 } 191 GNUNET_free (dth->url); 192 GNUNET_free (dth->instance_id); 193 GNUNET_free (dth->base_url); 194 GNUNET_free (dth); 195 } 196 197 198 /* end of merchant_api_delete-private-token.c */