Device App Test Report
RegisterTheandDevicesubmitApp Test Report API provides endpoints for registering network test reports from mobile applications or client devices. This functionality enables applications to submit diagnostic data, connectivity metrics, and performance test results to the server fordevicemonitoring,applications.analysis, and troubleshooting purposes.
Base URL: https://gate.zequenze.com/api/v1
Authentication: All endpoints require a Bearer token:
Authorization: Bearer <your-api-token>
Overview
The Device App Test Report API is designed to collect and process network diagnostic data from client applications and devices. This API category is essential for:
The test reports typically contain structured data about network conditions, device information, test parameters, and results. This data helps organizations maintain service quality, identify network bottlenecks, and proactively address connectivity problems before they impact users.
Common scenarios include mobile apps performing periodic connectivity checks, IoT devices reporting status, and diagnostic tools submitting comprehensive network analysis results.
Endpoints
POST /device_app_test_report/
SubmitDescription: Registers a new network test report forfrom a client device or application. This endpoint allowsaccepts devicesdiagnostic to register test resultsdata including network performance metrics, connectivity status,test results, device information, and environmental factors that may affect network performance. Use this endpoint whenever your application completes a network diagnostic test or needs to report connectivity status.
Use Cases:
Full URL Example:
https://gate.zequenze.com/api/v1/device_app_test_report/
Parameters:
| Parameter | Type | In | Required | Description |
|---|---|---|---|---|
| data | string | body | Yes |
ExamplecURL Request:Example:
curl -X POST "https://gate.zequenze.com/api/v1/device_app_test_report/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/jsonjson" Authorization:\
Bearer-d <your-api-token>
'{
"data": "{\"device_id\":\"device_001\device_12345\",\"app_version\":\"2.1.2.3\",\"test_timestamp\test_type\":\"connectivity_check\",\"timestamp\":\"2024-01-15T10:15T14:30:00Z\",\"network_tests\network_type\":{\"wifi\",\"signal_strength\":-45,\"latency_ms\":45,23,\"bandwidth_mbps\download_speed_mbps\":25.6,85.2,\"upload_speed_mbps\":42.7,\"packet_loss_percent\":0.1,\"connection_type\dns_resolution_time_ms\":15,\"connection_success\":true,\"server_endpoint\":\"api.example.com\",\"geolocation\":{\"latitude\":37.7749,\"longitude\":-122.4194},\"device_info\":{\"os\":\"iOS\",\"version\":\"17.1\",\"model\":\"iPhone 14\"}}"
}'
Example Request Body:
{
"data": "{\"device_id\":\"device_12345\",\"app_version\":\"2.1.3\",\"test_type\":\"connectivity_check\",\"timestamp\":\"2024-01-15T14:30:00Z\",\"network_type\":\"wifi\"},\"status\signal_strength\":-45,\"latency_ms\":23,\"download_speed_mbps\":85.2,\"upload_speed_mbps\":42.7,\"packet_loss_percent\":0.1,\"dns_resolution_time_ms\":15,\"connection_success\":true,\"server_endpoint\":\"passed\api.example.com\",\"errors\geolocation\":[]{\"latitude\":37.7749,\"longitude\":-122.4194},\"device_info\":{\"os\":\"iOS\",\"version\":\"17.1\",\"model\":\"iPhone 14\"}}"
}
Example Response:
{
"id": "report_12345",789456,
"status": "received",
"report_id": "rpt_2024011514300012345",
"timestamp": "2024-01-15T10:15T14:30:05Z"15Z",
"processed": false,
"message": "Test report successfully registered"registered and queued for processing"
}
Response Codes:
| Status | Description |
|---|---|
| 201 | Created - Test report successfully |
| 400 | Bad Request - Invalid |
| 401 | Unauthorized - |
Common Use Cases
Use Case 1: Mobile App Connectivity Monitoring
Mobile applications can use this endpoint to regularly submit network performance reports, helping identify connectivity issues across different carriers, locations, and network conditions. Submit reports after significant network events or on a scheduled basis.
Use Case 2: IoT Device Health Reporting
IoT devices can report their connectivity status, signal strength, and communication reliability to help maintain optimal network performance and identify devices that may need attention or repositioning.
Use Case 3: Quality Assurance Testing
During application testing phases, automated test suites can submit comprehensive network diagnostic reports to validate performance under various network conditions and identify potential issues before release.
Use Case 4: User Experience Troubleshooting
When users experience connectivity issues, applications can automatically generate and submit detailed diagnostic reports to help support teams quickly identify and resolve problems.
Use Case 5: Network Infrastructure Monitoring
Applications deployed across multiple locations can submit regular connectivity reports to help network administrators monitor infrastructure performance and identify areas needing improvement.
Best Practices
-
Data
FormatStructure Consistency:EnsureMaintain a consistent JSON structure within thedataparametercontainsacrossvalidallJSONtestasreportsatostring.enableDouble-encodeproperifanalysisnecessary.and trending -
TestIncludeTimingTimestamps:SubmitAlwaysreportsincludeimmediatelyaccurateafterUTC timestamps in your testcompletiondatafortoaccurateenabletimestamps.proper chronological analysis and correlation with network events