Reporting Issues¶
Before emailing, run through the quick checks below — most integration problems fall into one of these buckets.
Troubleshooting checklist¶
| Symptom | First thing to try |
|---|---|
| HTTP 401 Unauthorized | Access token expired (1 h lifetime). Refresh it — see Authentication. |
| HTTP 400 on submit | Check: quantile ordering (Q10 ≤ Q50 ≤ Q90), 15-min resolution, full day coverage (96 / 92 / 100 values on DST days), start_datetime / end_datetime in UTC. |
| HTTP 404 for a session / challenge | The session may have closed. Re-list open sessions; always trust the gate_closure field. |
| Empty list on scores / submissions | Evaluation requires measurement data. Confirm the challenge id and try again later. |
| Forecast accepted but day not scored / not ranked | Check Evaluation. Common causes: (i) Intraday day with no D+1/D+N commitment so pre-entry slots can't be filled, or (ii) D+1/D+N day where you submitted to only one of the two opened sessions. |
| HTTP 5xx | Platform issue — report it (details below). |
How to report¶
Email predico@inesctec.pt with:
- A short description of the problem.
- The API endpoint involved.
- Request payload and response body (redacted of secrets).
- Reproduction steps and timestamps (UTC).
- Your forecaster ID.
We aim to reply within a few business days. You'll be notified when the issue is reproduced, fixed and verified.