Skip to main content

Securedns Categoryget

Retrieve SecureDNS transaction category information by UUID.

Base URL: https://control.zequenze.com/api/v1

Authentication: All endpoints require a Bearer token:

Authorization: Bearer <your-api-token>

Endpoints

GET /securedns_categoryget/

Returns the category name of a SecureDNS transaction identified by its UUID. This endpoint allows you to retrieve classification information for specific DNS security transactions.

Parameters:

Parameter Type In Required Description
uuid string query Yes The UUID of the SecureDNS transaction

Example Request:

GET /api/v1/securedns_categoryget/?uuid=550e8400-e29b-41d4-a716-446655440000
Authorization: Bearer <your-api-token>

Example Response:

{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "category": "malware",
  "timestamp": "2024-01-15T10:30:00Z"
}
Status Description
200 Category request Ok
401 Category request not authorized
403 Category request forbidden / not allowed
404 Provided UUID don't match any transaction

Best Practices

  • Always validate UUIDs before making requests to avoid 404 errors
  • Store category information locally if you need to reference it frequently to reduce API calls
  • Implement proper error handling for 404 responses when UUIDs may not exist
  • Use appropriate retry logic for 401/403 errors after checking authentication credentials
  • Categories typically include values like: malware, phishing, spam, adult-content, or safe
Back to top