Assurance API
Support & FAQs
To get support from our team and view the status of the APIs, view our Support page.
Get Products
Question
Why is a different response payload received for different product types?
Answer
The Get Product API call queries our inventory, address database, orders and problem reports. The API will return as much rich information as we have available in order to support problem resolution. The information we have available will vary by product instance.
Question
When updating the WAN configuration, what do the ipMode values mean?
Answer
The GET /products/{productid}/wan response may or may not include the optional ipMode parameter.
- If the parameter is included, and the value is 1, then the IP mode is IPV4 only and the IPV4 attributes will be returned.
- If the parameter is included, and the value is 3, then the IP mode includes IPV4 and IPV6. Attributes will be returned for both.
- If the parameter is NOT included, the device is assumed to be IPV4 and IPV4 attributes will be returned.
Question
How do I update the WAN configuration when the ipMode parameter was not returned in the GET call?
Answer
When updating the WAN configuration using PUT /products/{productid}/wan, please note the following:
- If the ipMode parameter was NOT present in the GET call then it MUST NOT be included in the PUT call. As ipV4 mode is assumed the ipV4 object MUST be present in the PUT call.
- If the ipMode parameter was present in the GET call, then ipMode parameter MUST be present in the PUT call. If new value is 1 or 3 , then the ipV4 object MUST be included, If the new value is 3, then the ipV6 object MUST also be included.
Diagnostics
Question
When creating a new diagnostic, what happens if a diagnostic session already exists for the same product instance?
Answer
If it has been is less than one hour since the last interaction, that last interaction is reused, otherwise a new session is created.
Question
Under what circumstances should a diagnostic be cancelled?
Answer
A diagnostic session should only be cancelled if an incorrect product type has been submitted in the request.
Question
What are the expected response times for a diagnostic?
Answer
Response times will vary depending on the product type and the type of test run. Because of the asynchronous nature of the diagnostic API, there are two times to consider:
- The Diagnostic API which should respond within half a second.
The time for the actual test to complete running, depending on the type of test. Average times are:
- ONT Status, 10 seconds or less
- Single Line Test, 32 seconds or less
- Line State Diagnosis Test, 15 seconds or less
- Electrical Test, 50 seconds or less.
Question
How will I know when the diagnostic is complete?
Answer
You will need to poll the Assurance API until status ‘Complete’ is returned. We suggest you set polling to a 10 second interval.
Problem Reports
Question
Can a problem report be submitted a without having first run a diagnostic?
Answer
No, this is a process-driven API. The diagnosis flow on the service must be completed prior to logging a fault to ensure the correct information is submitted and the problem can be resolved as quickly as possible.
Question
What happens when a problem report is submitted?
Answer
A problem ticket is submitted to our ITSM problem management system and is automatically allocated to the appropriate resolver group. A reference number is returned as part of the API response. When the problem report is submitted, the diagnostics session is completed.
Question
Howcan an appointment time be changed?
Answer
To request a change of appointment time, either submit an update to the problem report with some appointment options for Assure to select from, or depending on the status of the problem report, cancel and resubmit the problem report.
Question
What is the difference between amending and updating a problem report?
Answer
Amending a problem report enables all edible properties of the original problem to be resubmitted. Updating a problem report adds additional information to the report, for example “Tech replaced faulty card”.
Question
Can a closed problem report be amended?
Answer
No. Once a problem report is closed, a new diagnosis and problem report must be submitted.
Question
Can a second problem report be opened for the same product instance if there is already one open?
Answer
No, this is not supported as part of our BAU Assure process.
Events
Question
Can I still log a problem report if my service is effected by an event but not event related?
Answer
Yes, This is known as a secondary fault and will be processed as usual.