api.h

#ifndef API_H
#define API_H
 
#include "types.h"
#include <gdal/ogr_core.h>
#include <stddef.h>
#include <curl/curl.h>
#include <jansson.h>
 
#define BASEURL "https://cds.climate.copernicus.eu/api"

struct curl_slist *customHeader(struct curl_slist *list, const option_t *options);

int initializeHandle(CURL **handle, const struct curl_slist *headerList);

CURL *newHandleWithOptions(struct curl_slist **list, const option_t *options);

size_t writeString(char *ptr, size_t size, size_t nmemb, void *userdata);

size_t discardWrite(char *ptr, size_t size, size_t nmemb, void *userdata);

json_t *getKeyRecursively(json_t *root, const char *key);

json_t *jsonArrayFromIntegers(const int *arr, size_t elements, const char *formatString);

char *constructStringRequest(const int *years, const int *months, const int *days, const int *hours,
                             const size_t yearsElements, const size_t monthsElements, const size_t daysElements,
                             const size_t hoursElements, const OGREnvelope *aoi);

[[nodiscard]] int download(CURL *handle, const option_t *options, const OGREnvelope *aoi);

char *slurpAndGetString(const char *input, const char *key);

[[nodiscard]] int handleDownloadChain(CURL *handle, const option_t *options, const OGREnvelope *aoi,
                                      const char *outputPath, const int *subsetYears, const int *subsetMonths, const int *subsetDays,
                                      const int *subsetHours, const size_t yearsElements, const size_t monthsElements,
                                      const size_t daysElements, const size_t hoursElements, const unsigned int maxAttempts);

char *cdsRequestProduct(CURL *handle, const int *years, const int *months, const int *days,
                        const int *hours, const size_t yearsElements, const size_t monthsElements,
                        const size_t daysElements, const size_t hoursElements, const OGREnvelope *aoi,
                        const option_t *options);

productStatus cdsGetProductStatus(CURL *handle, const char *requestId,
                                  const option_t *options); // Result.update

int binaryExponentialBackoff(int attempt);

int cdsWaitForProduct(CURL *handle, const char *requestId, const option_t *options,
                      unsigned int maxAttempts);

int cdsDownloadProduct(CURL *handle, const char *requestId,
                       const char *outputPath, const option_t
                       *options); // same URL as product status but with /results appended which then returns the actual download URL

int cdsDeleteProductRequest(CURL *handle, const char *requestId,
                            const option_t *options); // Result.delete
 // end of group
#endif // API_H