devilutionX-libzt/examples/cpp/centralapi.cpp

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#include <string>
#include <iomanip>
#include <iostream>

#include "ZeroTierSockets.h"

// For optional JSON parsing
#include "../ext/ZeroTierOne/ext/json/json.hpp"

void process_response(char *response, int http_response_code)
{
	if (http_response_code == 0) {
		// Request failed at library level, do nothing. There would be no HTTP code at this point.
		return;
	}
	printf("Raw response string (%d) = %s\n", http_response_code, response);
	// Parse into navigable JSON object
	if (http_response_code < 200 || http_response_code >= 300) {
		return;
	}
	nlohmann::json res = nlohmann::json::parse(response);
	if (!res.is_object()) {
		fprintf(stderr, "Unable to parse (root element is not a JSON object)");
	}
	// Pretty print JSON blob
	std::cout << std::setw(4) << res << std::endl;
}

int main(int argc, char **argv)
{
	if (argc != 3) {
		printf("\nlibzt example central API client\n");
		printf("centralapi <central_url> <api_token>\n");
		exit(0);
	}
	std::string central_url = argv[1]; // API endpoint
	std::string api_token = argv[2]; // User token (generate at my.zerotier.com)
	
	/**
	 * This example demonstrates how to use the ZeroTier Central API to:
	 *
	 *  - Get the status of our hosted service (or your own)
	 *  - Create a network
	 *  - Get the full configuration of a network
	 *  - Authorize/Deauthorize nodes on a network
	 *
	 * This example does not start a node (though you can if you wish.) This portion of the
	 * libzt API is merely a wrapper around our web API endpoint (https://my.zerotier.com/help/api).
	 * The HTTP requests are done via libcurl. This API is thread-safe but not multithreaded.
	 *
	 * Error Codes:
	 *         -2 : [ZTS_ERR_SERVICE] The API may not have been initialized properly
	 *         -3 : [ZTS_ERR_ARG] Invalid argument
	 *  [100-500] : Standard HTTP error codes  
	 *
	 * Usage example: centralapi https://my.zerotier.com e7no7nVRFItge7no7cVR5Ibge7no8nV1
	 *
	 */

	int err = ZTS_ERR_OK;
	// Buffer to store server response as JSON string blobs
	char rbuf[CENTRAL_API_RESP_BUF_DEFAULT_SZ];

	// Provide URL to Central API server and user API token generated at https://my.zerotier.com
	printf("Initializing Central API client...\n");
	if ((err = zts_central_api_init(central_url.c_str(), api_token.c_str(), rbuf, CENTRAL_API_RESP_BUF_DEFAULT_SZ)) != ZTS_ERR_OK) {
		fprintf(stderr, "Error while initializing client's Central API parameters\n");
		return 0;
	}

	zts_central_api_set_verbose(false); // (optiona) Turn on reporting from libcurl
	zts_central_api_set_access(ZTS_CENTRAL_READ | ZTS_CENTRAL_WRITE);

	int http_res_code = 0;

	// Get hosted service status
	printf("Requesting Central API server status (/api/status):\n");
	if ((err = zts_central_api_get_status(&http_res_code)) != ZTS_ERR_OK) {
		fprintf(stderr, "Error (%d) making the request.\n", err);
	} else {
		process_response(rbuf, http_res_code);
	}
	// Get network config
	int64_t nwid = 0x1234567890abcdef;
	printf("Requesting network config: /api/network/%llx\n", nwid);
	if ((err = zts_central_api_get_network(&http_res_code, nwid)) != ZTS_ERR_OK) {
		fprintf(stderr, "Error (%d) making the request.\n", err);
	} else {
		process_response(rbuf, http_res_code);
	}
	// Authorize a node on a network
	int64_t nodeid = 0x9934343434;
	printf("Authorizing: /api/network/%llx/member/%llx\n", nwid, nodeid);
	if ((err = zts_set_node_auth(&http_res_code, nwid, nodeid, ZTS_CENTRAL_NODE_AUTH_TRUE)) != ZTS_ERR_OK) {
		fprintf(stderr, "Error (%d) making the request.\n", err);
	} else {
		process_response(rbuf, http_res_code);
	}

	return 0;
}