- API Reference
- Box API
- Stats & logs
Summarise rotations of one slot in a range (success rate, unique IPs, average time)
Use this to judge rotation quality of a slot. Counts success, failed and duplicated rotations, the average rotation time in seconds, and lists each distinct IPv4 with how often it was seen (least seen first).
GET
/v2/rotation_history_analysisQuery parameters
positionintegerrequired
start_dateintegerrequired
Epoch seconds.
end_dateintegerrequired
Epoch seconds.
Responses
Analysis or an error.
statusbooleanoptional
msgstringoptional
dataobjectoptional
data.total_itemsintegeroptional
data.total_successintegeroptional
data.total_failedintegeroptional
data.total_duplicatedintegeroptional
data.avg_rotation_timenumber | nulloptional
data.total_unique_ipintegeroptional
data.unique_itemsobject[]optional
data.unique_items[].posintegeroptional
data.unique_items[].current_ip4string | nulloptional
data.unique_items[].current_ip6string | nulloptional
data.unique_items[].occurrencesintegeroptional
The caller is not trusted (not loopback, LAN, whitelisted or allowed Tailscale) and sent no valid Basic credentials. The body depends on whether "Basic auth for all API" is on. Routes that also use the panel login can answer a plain-text 401 "Unauthorized Access" instead.
Errors returned in msg
| msg | Meaning | What to do |
|---|---|---|
Have an error during request! Contact administrator! | A parameter is missing or not a number or the query failed. | Send integer position and epoch-second dates. |