Customer Management
๐งพ Overviewโ
Reseller accounts can manage their own customers through the Scriptix Reseller API. This includes creating, retrieving, updating, and removing customer records.
โ Create Customerโ
URL: POST /api/v3/reseller/customer/
Headers:
Parameter | Value | Description |
---|---|---|
Content-Type | application/json | |
x-zoom-s2t-key | Scriptix Reseller API Key | Must be a valid reseller API token |
JSON Body:
{
"name": "Customer Name",
"email": "customer@example.com",
"phone": "+31 012 345678"
}
Response: 201 Created
{
"result": {
"id": 1,
"name": "Customer Name",
"email": "customer@example.com",
"phone": "+31 012 345678",
"is_active": true,
"registration_date": "2025-01-25T10:31:46.960Z",
"last_modified": "2025-01-25T10:31:46.960Z"
},
"count": 1,
"total_results": 1
}
๐ Get Customerโ
URL: GET /api/v3/reseller/customer/{id}/
Headers:
Parameter | Description |
---|---|
x-zoom-s2t-key | Scriptix Reseller API Token |
Path Parameters:
Name | Description |
---|---|
id | ID of the customer |
Response: 200 OK
Returns the same structure as Create Customer
.
โ๏ธ Update Customerโ
URL: PUT /api/v3/reseller/customer/{id}/
Headers:
Parameter | Description |
---|---|
Content-Type | application/json |
x-zoom-s2t-key | Scriptix Reseller API Token |
Path Parameters:
Name | Description |
---|---|
id | ID of the customer |
JSON Body:
{
"name": "Customer Name",
"email": "customer@example.com",
"phone": "+31 012 345678"
}
Response: 201 Customer updated
Returns the same structure as Create Customer
.
๐๏ธ Remove Customerโ
URL: DELETE /api/v3/reseller/customer/{id}/
Headers:
Parameter | Description |
---|---|
x-zoom-s2t-key | Scriptix Reseller API Token |
Path Parameters:
Name | Description |
---|---|
id | ID of the customer |
Response: 204 No Content
โ Response Codesโ
Status Code | Description |
---|---|
201 | Created / Updated successfully |
200 | Retrieved successfully |
204 | Deleted successfully (no content) |
400 | Bad request โ check payload or path |
401 | Unauthorized โ invalid or missing token |
403 | Forbidden โ token lacks permission |
404 | Not found โ customer ID doesn't exist or is inaccessible |
500 | Internal error โ contact support if persistent |
๐ง Use Casesโ
- Manage multiple clients under a single reseller account
- Provide isolated transcription access per customer
- Keep customer records organized with metadata
๐ Next Stepsโ
- Usage Tracking โ Monitor customer activity
- Custom Models โ Train models per client needs
- Authentication โ Learn about API tokens