Skip to main content

Device App Test Report

Register and submit network test reports for device applications.

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

Authentication: All endpoints require a Bearer token:

Authorization: Bearer <your-api-token>

Endpoints

POST /device_app_test_report/

Submit a network test report for a device application. This endpoint allows devices to register test results including network performance metrics, connectivity status, and diagnostic information.

Parameters:

Parameter Type In Required Description
data string body Yes JSON string containing the test report data

Example Request:

POST /api/v1/device_app_test_report/
Content-Type: application/json
Authorization: Bearer <your-api-token>

{
  "data": "{\"device_id\":\"device_001\",\"app_version\":\"1.2.3\",\"test_timestamp\":\"2024-01-15T10:30:00Z\",\"network_tests\":{\"latency_ms\":45,\"bandwidth_mbps\":25.6,\"packet_loss_percent\":0.1,\"connection_type\":\"wifi\"},\"status\":\"passed\",\"errors\":[]}"
}

Example Response:

{
  "id": "report_12345",
  "status": "received",
  "timestamp": "2024-01-15T10:30:05Z",
  "message": "Test report successfully registered"
}
Status Description
201 Test report successfully created
400 Invalid request data or malformed JSON
401 Unauthorized - invalid or missing token
422 Validation error in test report data

Best Practices

  • Data Format: Ensure the data parameter contains valid JSON as a string. Double-encode if necessary.
  • Test Timing: Submit reports immediately after test completion for accurate timestamps.
  • Error Handling: Include detailed error information in the report data for better diagnostics.
  • Network Conditions: Capture network conditions at the time of testing for context.
  • Device Information: Always include device ID and app version for proper tracking.
  • Batch Reporting: For multiple tests, consider sending individual reports rather than batching to ensure data integrity.
Back to top