2023-01-17 | Changes in Central Bulk API Response

Does it impact me?

It only impacts you if you’re using:

  1. central-api.phonon.io

and not:

  1. central.phonon.io

Executive Summary:

Following URL:

https://central-api.phonon.io/kairos-apis/outbound/create

was yielding the following response before:

{ "api-response-code": 200, "api-response-message": "Success", "request-id": "49efc4f5-19ea-46b5-b114-0e8336c433ee", "call-details": [ { "client-identifier": "3ee266dd-8945-4cd5-ac11-5f07d31adce3", "phonon-uuid": "57288c7f-68a5-4a34-81f1-3efad1cd7f82" }, { "client-identifier": "145797e8-ea79-4cb8-a848-eef7227f27f5", "phonon-uuid": "bc11949a-65f4-491d-8840-3eb11121919e" } ] }

will now be yielding the following response now:

This has been updated on Thursday 16th, March, 2023.

{ "api-response-code": 202, "api-response-message": "Accepted", "request-id": "9ae732e9-aa25-4e19-a66c-dd18bd9a51f7", "call-details": null }

 

and:

  1. The Phonon UUID is not shared in the response.

  2. The Request ID is shared and can be used to track the status in your account.

  3. The response status code is 202

  4. The Whitelist IP section of the Central Admin Portal will not implement on the bulk API. You can reach out to your Account Manager or help@phonon.io for any IP whitelisting. If your IP is not whitelisted, you’ll get a 403 status code.

Why are the changes made?

We have made the changes in the Bulk API module of Central, that increases our API throughput capability by more than 10x.

What are the upcoming changes?

  1. The response JSON will be further enhanced to communicate scenarios in case of an error.

I need more information, what can I do?

Reach out to your Account Manager or help@phonon.io for the same.

This document has been developed by Phonon.io for the sole and exclusive use of the customer / prospective customer with whom this document is being shared. Further, this document has been provided by Phonon.io to the recipient in good faith and based on request from the recipient for the same. This document is a confidential document and contains confidential product technology, workflow and commercial details that are for the sole usage of the intended recipients of this document. Recipients are advised not to share this document with any third party that is not the intended recipient of this document and neither to bring this document in full or parts into the public domain. Any unauthorized access may be brought to Phonon.io’s notice immediately. Phonon.io is free to take any legal action it deems necessary against any person or entity that violates this confidentiality agreement. Phonon.io is bound and governed by the rules of the state of Gujarat in India. In case you are not in agreement with the terms set in this clause or are not an intended recipient of this document, please destroy the document and intimate us of the same at info@phonon.io.