Add prototype Central API wrapper

examples/cpp/centralapi.cpp

@@ -0,0 +1,105 @@
+#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;
+}