Question

Glip Archive Export API breaking change

  • 15 January 2020
  • 4 replies
  • 623 views

Hey RingCentral,

We're seeing some different behavior in the Glip Archive API today.

The archive data structure used to look like this:
{
  "uri": "https://platform.ringcentral.com/restapi/v1.0/glip/data-export/.....",
  "id": ".....",
  "creationTime": "2019-05-03T00:02:04Z",
  "lastModifiedTime": "2019-05-03T00:02:05Z",
  "status": "Completed",
  "result": [
    {
      "size": 1018,
      "uri": "https://media.ringcentral.com/restapi/v1.0/glip/data-export/...../archive/1"
    }
  ]
}
Now it looks like this:
{
  "uri": "https://platform.ringcentral.com/restapi/v1.0/glip/data-export/.....",
  "id": ".....",
  "creationTime": "2020-01-15T05:09:02Z",
  "lastModifiedTime": "2020-01-15T05:09:06Z",
  "status": "Completed",
  "creator": {
    "id": "....",
    "firstName": "...",
    "lastName": "..."
  },
  "specific": {
    "timeFrom": "2020-01-13T00:00:00Z",
    "timeTo": "2020-01-15T05:09:02Z"
  },
  "datasets": [
    {
      "id": "1",
      "size": 271709,
      "uri": "https://media.ringcentral.com/restapi/v1.0/glip/data-export/...../archive/1"
    }
  ]
}

The list of archive files is now in a field called `datasets` and the timeFrom date has been backdated a day to a midnight UTC value.

What's up? Was notification of this change made to the developer community?

4 replies

Userlevel 1

Hi Rich,

My apologies for the inconvenience!

There were changes in the response structure and we communicated via email to account owners who used the APIs. I don't know why you were not receiving the notification about the changes.

The API was in beta and now it is final. Do you mind to give me your account id (or main company number) so I can check the reason why it was missing from the impacted account list.

About the sandbox, I think the new release has not been rolled out to the sandbox environment yet. I will check with the eng. team to make sure both environments would work the same way.

We've also determined that the format of the data in the archive itself has breaking changes, so this is more than just the API.

Hey Phong - thanks for the update. The issue with us as a partner is not that exports are changed for *our* RingCentral enviornment, it's that *our customers* who rely on us to pull their compliance archives from RingCnetral and archive their data have experienced a service interruption.

I'll follow up with you over email.

This is a huge issue for customers in a regulated environment. This needs to be addressed ASAP!!!!!

Reply