Summary
The report method offers a mechanism to send information about the guide back to RadioTime.
Report Wizard
An easy way to narrow informational or listening experience problems is to use our problem wizard. It is ideal for point/click or browse/select environments in which typing is unavailable or difficult. Often, users will get to a specific cause in less than three choices. The final option sends a ticket into our CRM for moderator review.
Example
GET http://opml.radiotime.com/Report.ashx?c=wizard&id=s32500
Input
| Parameter | Description |
|---|---|
| c | Set to wizard for this call |
| id | The guide ID of the item that triggered the report |
Output
Each call to the wizard generates a menu of narrower options until the end of a particular trail is reached, at which we point we provide a “thank you” message and create a ticket.
Report Feedback
Accepts free text comments/concerns/complaints about a specific show or station.
Example
GET http://opml.radiotime.com/Report.ashx?c=feedback&id=s32500&email=user@username.org&text=Station+call+sign+changed
Input
| Parameter | Required | Description |
|---|---|---|
| c | Yes | Classifier – set to “feedback” for this method |
| id | Yes | The guide item for which the feedback applies |
| No | The email address of the user submitting the feedback. Will only be used in the context of resolving the issue | |
| text | Yes | The feedback text |
Output
None; check the status code in the document header for success or failure.
| Status | Description |
|---|---|
| 200 | Feedback accepted |
| 400 | Invalid input – check the <fault> for details |
| 500 | Feedback rejected – check the <fault> for details |
Notes
The example shows an HTTP GET request, but for long textual feedback we recommend POST instead. The parameter names should be the same.
Report Stream Failures
Accepts error information specific to a stream play attempt.
Example
GET http://opml.radiotime.com/Report.ashx?c=stream&id=s32500&error=404&message=File+Not+Found
Input
| Parameter | Required | Description |
|---|---|---|
| c | Yes | Classifier – set to “stream” for this method |
| id | Yes, if no URL provided | Typically the station that failed playback |
| url | Yes, if no ID provided | The stream URL that failed playback |
| error | Yes, if no message | Your numeric application error code |
| message | Yes, if no error code | The textual error message |
Output
None; check the status code in the document header for success or failure.