diff --git a/zerotier-central-api/Cargo.toml b/zerotier-central-api/Cargo.toml index 22b7dd3..82d64ed 100644 --- a/zerotier-central-api/Cargo.toml +++ b/zerotier-central-api/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "zerotier-central-api" -version = "1.1.0" +version = "1.2.0" edition = "2021" description = "ZeroTier Central API for Rust" authors = ["Erik Hollensbe ", "Adam Ierymenko "] diff --git a/zerotier-central-api/openapi.json b/zerotier-central-api/openapi.json index a73ac97..2f3cc3f 100644 --- a/zerotier-central-api/openapi.json +++ b/zerotier-central-api/openapi.json @@ -1,7 +1,7 @@ { "openapi": "3.0.0", "info": { - "description": "ZeroTier Central Network Management Portal API.

All API requests must have an API token header specified in the Authorization: Bearer xxxxx format. You can generate your API key by logging into ZeroTier Central and creating a token on the Account page.

eg. curl -X GET -H \"Authorization: bearer xxxxx\" https://my.zerotier.com/api/v1/network

Rate Limiting

The ZeroTier Central API implements rate limiting. Paid users are limited to 100 requests per second. Free users are limited to 20 requests per second.

You can get the OpenAPI spec here as well: https://docs.zerotier.com/openapi/centralv1.json

", + "description": "ZeroTier Central Network Management Portal API.

All API requests must have an API token header specified in the Authorization: token xxxxx format. You can generate your API key by logging into ZeroTier Central and creating a token on the Account page.

eg. curl -X GET -H \"Authorization: token xxxxx\" https://api.zerotier.com/api/v1/network

Rate Limiting

The ZeroTier Central API implements rate limiting. Paid users are limited to 100 requests per second. Free users are limited to 20 requests per second.

You can get the OpenAPI spec here as well: https://docs.zerotier.com/openapi/centralv1.json

", "version": "v1", "title": "ZeroTier Central API", "contact": { @@ -15,7 +15,7 @@ }, "servers": [ { - "url": "https://my.zerotier.com/api/v1", + "url": "https://api.zerotier.com/api/v1", "description": "Production Server" } ], @@ -936,9 +936,9 @@ }, "components": { "securitySchemes": { - "bearerAuth": { + "tokenAuth": { "type": "http", - "scheme": "bearer" + "scheme": "token" } }, "responses": { @@ -999,7 +999,8 @@ "type": "integer", "example": 123, "readOnly": true, - "nullable": true + "nullable": true, + "description": "Note: May be 0 on endpoints returning lists of Networks" }, "authorizedMemberCount": { "type": "integer", @@ -1197,14 +1198,14 @@ "type": "integer", "format": "int64", "readOnly": true, - "description": "Last seen time of the member", + "description": "Last seen time of the member. Note: This data is considered ephemeral and may be reset to 0 at any time without warning.", "example": 1612993673254, "nullable": true }, "physicalAddress": { "type": "string", "readOnly": true, - "description": "IP address the member last spoke to the controller via", + "description": "IP address the member last spoke to the controller via. Note: This data is considered ephemeral and may be reset to 0 at any time without warning.", "example": "8.8.8.8", "nullable": true }, diff --git a/zerotier-one-api/Cargo.toml b/zerotier-one-api/Cargo.toml index 4b8957d..fe3ec94 100644 --- a/zerotier-one-api/Cargo.toml +++ b/zerotier-one-api/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "zerotier-one-api" -version = "1.1.0" +version = "1.2.0" edition = "2021" description = "OpenAPI bindings to the ZeroTierOne JSON API" authors = ["Erik Hollensbe ", "Adam Ierymenko "] diff --git a/zerotier-one-api/openapi.json b/zerotier-one-api/openapi.json index e72deb1..22c2bc3 100644 --- a/zerotier-one-api/openapi.json +++ b/zerotier-one-api/openapi.json @@ -3,7 +3,7 @@ "info": { "title": "ZeroTierOne Service API", "version": "0.1.0", - "description": "

This API controls the ZeroTier service that runs in the background on your computer. This is how zerotier-cli, and the macOS and Windows apps control the service.

API requests must be authenticated via an authentication token. ZeroTier One saves this token in the authtoken.secret file in its working directory. This token may be supplied via the X-ZT1-Auth HTTP request header.

For example: curl -H \"X-ZT1-Auth: $TOKEN\" http://localhost:9993/status

The token can be found in:

  • Mac :: /Library/Application Support/ZeroTier/One
  • Windows :: \\ProgramData\\ZeroTier\\One
  • Linux :: /var/lib/zerotier-one

You can get the OpenAPI spec here as well: https://docs.zerotier.com/openapi/servicev1.json

", + "description": "

This API controls the ZeroTier service that runs in the background on your computer. This is how zerotier-cli, and the macOS and Windows apps control the service.

API requests must be authenticated via an authentication token. ZeroTier One saves this token in the authtoken.secret file in its working directory. This token may be supplied via the X-ZT1-Auth HTTP request header.

For example: curl -H \"X-ZT1-Auth: $TOKEN\" http://localhost:9993/status

The token can be found in:

  • Mac :: ~/Library/Application Support/ZeroTier/authtoken.secret
  • Windows :: \\ProgramData\\ZeroTier\\One
  • Linux :: /var/lib/zerotier-one

You can get the OpenAPI spec here as well: https://docs.zerotier.com/openapi/servicev1.json

", "license": { "name": "Apache 2.0", "url": "http://www.apache.org/licenses/LICENSE-2.0.html"