mirror of https://github.com/zerotier/ZeroTierOne.git synced 2024-12-25 15:41:05 +00:00

History

Adam Ierymenko a95fa379cc Circuit tests basically work but need some tweaks, and fix some issues found with valgrind.		2015-10-09 14:51:38 -07:00
..
circuit-test-pingpong.json	Circuit tests basically work but need some tweaks, and fix some issues found with valgrind.	2015-10-09 14:51:38 -07:00
public.json	Add more helpful example stuff.	2015-10-09 12:50:52 -07:00
README.md	Add more helpful example stuff.	2015-10-09 12:50:52 -07:00

README.md

API Examples

This folder contains examples that can be posted with curl or another http query utility to a local instance.

To test querying with curl:

curl -H 'X-ZT1-Auth:AUTHTOKEN' http://127.0.0.1:9993/status

To create a public network on a local controller (service must be built with "make ZT_ENABLE_NETWORK_CONTROLLER=1"):

curl -H 'X-ZT1-Auth:AUTHTOKEN' -X POST -d @public.json http://127.0.0.1:9993/controller/network/################

Replace AUTHTOKEN with the contents of this instance's authtoken.secret file and ################ with a valid network ID. Its first 10 hex digits must be the ZeroTier address of the controller itself, while the last 6 hex digits can be anything. Also be sure to change the port if you have this instance listening somewhere other than 9993.

After POSTing you can double check the network config with:

curl -H 'X-ZT1-Auth:AUTHTOKEN' http://127.0.0.1:9993/controller/network/################

Once this network is created (and if your controller is online, etc.) you can then join this network from any device anywhere in the world and it will receive a valid network configuration.