/* This file is part of TALER Copyright (C) 2020 Taler Systems SA TALER is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1, or (at your option) any later version. TALER is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with TALER; see the file COPYING.LGPL. If not, see */ /** * @file lib/merchant_api_post_instances.c * @brief Implementation of the POST /instances request * of the merchant's HTTP API * @author Christian Grothoff */ #include "platform.h" #include #include #include /* just for HTTP status codes */ #include #include "taler_merchant_service.h" #include #include /** * Handle for a POST /instances/$ID operation. */ struct TALER_MERCHANT_InstancesPostHandle { /** * The url for this request. */ char *url; /** * Handle for the request. */ struct GNUNET_CURL_Job *job; /** * Function to call with the result. */ TALER_MERCHANT_InstancesPostCallback cb; /** * Closure for @a cb. */ void *cb_cls; /** * Reference to the execution context. */ struct GNUNET_CURL_Context *ctx; /** * Minor context that holds body and headers. */ struct TALER_CURL_PostContext post_ctx; }; /** * Function called when we're done processing the * HTTP POST /instances request. * * @param cls the `struct TALER_MERCHANT_InstancesPostHandle` * @param response_code HTTP response code, 0 on error * @param json response body, NULL if not in JSON */ static void handle_post_instances_finished (void *cls, long response_code, const void *response) { struct TALER_MERCHANT_InstancesPostHandle *iph = cls; const json_t *json = response; struct TALER_MERCHANT_HttpResponse hr = { .http_status = (unsigned int) response_code, .reply = json }; iph->job = NULL; GNUNET_log (GNUNET_ERROR_TYPE_INFO, "POST /instances completed with response code %u\n", (unsigned int) response_code); switch (response_code) { case 0: hr.ec = TALER_EC_INVALID_RESPONSE; break; case MHD_HTTP_NO_CONTENT: break; case MHD_HTTP_BAD_REQUEST: hr.ec = TALER_JSON_get_error_code (json); hr.hint = TALER_JSON_get_error_hint (json); /* This should never happen, either us * or the merchant is buggy (or API version conflict); * just pass JSON reply to the application */ break; case MHD_HTTP_FORBIDDEN: hr.ec = TALER_JSON_get_error_code (json); hr.hint = TALER_JSON_get_error_hint (json); /* Nothing really to verify, merchant says we tried to abort the payment * after it was successful. We should pass the JSON reply to the * application */ break; case MHD_HTTP_NOT_FOUND: hr.ec = TALER_JSON_get_error_code (json); hr.hint = TALER_JSON_get_error_hint (json); /* Nothing really to verify, this should never happen, we should pass the JSON reply to the application */ break; case MHD_HTTP_CONFLICT: hr.ec = TALER_JSON_get_error_code (json); hr.hint = TALER_JSON_get_error_hint (json); break; case MHD_HTTP_INTERNAL_SERVER_ERROR: hr.ec = TALER_JSON_get_error_code (json); hr.hint = TALER_JSON_get_error_hint (json); /* Server had an internal issue; we should retry, but this API leaves this to the application */ break; default: TALER_MERCHANT_parse_error_details_ (json, response_code, &hr); /* unexpected response code */ GNUNET_log (GNUNET_ERROR_TYPE_ERROR, "Unexpected response code %u/%d\n", (unsigned int) response_code, (int) hr.ec); GNUNET_break_op (0); break; } iph->cb (iph->cb_cls, &hr); TALER_MERCHANT_instances_post_cancel (iph); } /** * Setup an new instance in the backend. * * @param ctx the context * @param backend_url HTTP base URL for the backend * @param instance_id identity of the instance to get information about * @param payto_uris_length length of the @a accounts array * @param payto_uris URIs of the bank accounts of the merchant instance * @param name name of the merchant instance * @param address physical address of the merchant instance * @param jurisdiction jurisdiction of the merchant instance * @param default_max_wire_fee default maximum wire fee merchant is willing to fully pay * @param default_wire_fee_amortization default amortization factor for excess wire fees * @param default_max_deposit_fee default maximum deposit fee merchant is willing to pay * @param default_wire_transfer_delay default wire transfer delay merchant will ask for * @param default_pay_delay default validity period for offers merchant makes * @param cb function to call with the * backend's instances information * @param cb_cls closure for @a config_cb * @return the instances handle; NULL upon error */ struct TALER_MERCHANT_InstancesPostHandle * TALER_MERCHANT_instances_post ( struct GNUNET_CURL_Context *ctx, const char *backend_url, const char *instance_id, unsigned int accounts_length, const char *payto_uris[], const char *name, const json_t *address, const json_t *jurisdiction, const struct TALER_Amount *default_max_wire_fee, uint32_t default_wire_fee_amortization, const struct TALER_Amount *default_max_deposit_fee, struct GNUNET_TIME_Relative default_wire_transfer_delay, struct GNUNET_TIME_Relative default_pay_delay, TALER_MERCHANT_InstancesPostCallback cb, void *cb_cls) { struct TALER_MERCHANT_InstancesPostHandle *iph; json_t *jpayto_uris; json_t *req_obj; jpayto_uris = json_array (); if (NULL == jpayto_uris) { GNUNET_break (0); return NULL; } for (unsigned int i = 0; ictx = ctx; iph->cb = cb; iph->cb_cls = cb_cls; iph->url = TALER_url_join (backend_url, "private/instances", NULL); if (NULL == iph->url) { GNUNET_log (GNUNET_ERROR_TYPE_ERROR, "Could not construct request URL.\n"); json_decref (req_obj); GNUNET_free (iph); return NULL; } { CURL *eh; eh = curl_easy_init (); if (GNUNET_OK != TALER_curl_easy_post (&iph->post_ctx, eh, req_obj)) { GNUNET_break (0); json_decref (req_obj); GNUNET_free (iph); return NULL; } json_decref (req_obj); GNUNET_assert (CURLE_OK == curl_easy_setopt (eh, CURLOPT_URL, iph->url)); iph->job = GNUNET_CURL_job_add2 (ctx, eh, iph->post_ctx.headers, &handle_post_instances_finished, iph); } return iph; } /** * Cancel /instances request. Must not be called by clients after * the callback was invoked. * * @param igh request to cancel. */ void TALER_MERCHANT_instances_post_cancel ( struct TALER_MERCHANT_InstancesPostHandle *iph) { if (NULL != iph->job) { GNUNET_CURL_job_cancel (iph->job); iph->job = NULL; } TALER_curl_easy_post_finished (&iph->post_ctx); GNUNET_free (iph->url); GNUNET_free (iph); } /* end of merchant_api_post_instances.c */