Technical Documentation & APIs
Start Building with Your Free API Key
Everything developers need to build, scale, and integrate with ZWS.
Trusted by 5,000+ developers across 40+ countries
API Explorer
Authentication
POST
/auth/token
Users
GET
/users
POST
/users
Data
POST
/data/push
Request
POST
Request Body
{
"username": "your-username",
"password": "your-password",
"client_id": "your-client-id"
}
Code Snippets
import requests
url = "https://api.zws.com/v1/auth/token"
payload = {
"username": "your-username",
"password": "your-password",
"client_id": "your-client-id"
}
response = requests.post(url, json=payload)
token = response.json()["access_token"]
const axios = require('axios');
const url = 'https://api.zws.com/v1/auth/token';
const payload = {
username: 'your-username',
password: 'your-password',
client_id: 'your-client-id'
};
const { data } = await axios.post(url, payload);
const token = data.access_token;
HttpClient client = HttpClient.newHttpClient();
String body = """
{"username":"your-username",
"password":"your-password",
"client_id":"your-client-id"}""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.zws.com/v1/auth/token"))
.POST(HttpRequest.BodyPublishers.ofString(body))
.header("Content-Type","application/json")
.build();
HttpResponse<String> response =
client.send(request, BodyHandlers.ofString());
package main
import (
"bytes"; "encoding/json"; "net/http"
)
func main() {
payload, _ := json.Marshal(map[string]string{
"username": "your-username",
"password": "your-password",
"client_id": "your-client-id",
})
resp, _ := http.Post(
"https://api.zws.com/v1/auth/token",
"application/json",
bytes.NewBuffer(payload),
)
defer resp.Body.Close()
}
using var client = new HttpClient();
var payload = new {
username = "your-username",
password = "your-password",
client_id = "your-client-id"
};
var resp = await client.PostAsJsonAsync(
"https://api.zws.com/v1/auth/token", payload);
var json = await resp.Content.ReadFromJsonAsync<dynamic>();
<?php
$ch = curl_init('https://api.zws.com/v1/auth/token');
$payload = json_encode([
'username' => 'your-username',
'password' => 'your-password',
'client_id' => 'your-client-id'
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER,
['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
require 'net/http'
require 'json'
uri = URI('https://api.zws.com/v1/auth/token')
payload = {
username: 'your-username',
password: 'your-password',
client_id: 'your-client-id'
}
resp = Net::HTTP.post(
uri, payload.to_json,
'Content-Type' => 'application/json'
)
token = JSON.parse(resp.body)['access_token']
Response
Status: 200 OK
Time: 142ms
{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"token_type": "Bearer",
"expires_in": 3600,
"refresh_token": "def502004b8c..."
}
AI Assistant
Hi! I can help you write code snippets, explain API responses, or assist with integration. Try asking: "Write me a Python snippet for authentication"