question

rich-sutton avatar image
rich-sutton asked ·

Glip Archive Export API breaking change

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?
glipcompliance
1 comment
1 |1000 characters needed characters left characters exceeded

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

I have confirmed that the sandbox API still returns the documented data structure, so this change appears to only be in production.

0 Likes 0 · ·
Phong Vu avatar image
Phong Vu answered ·

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.

Share
1 |1000 characters needed characters left characters exceeded

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

rich-sutton avatar image
rich-sutton answered ·

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.

Share
1 |1000 characters needed characters left characters exceeded

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

rich-sutton avatar image
rich-sutton answered ·

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.

1 comment Share
1 |1000 characters needed characters left characters exceeded

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

I saw you on our Glip team. Let's work on this directly and more instantly in that Glip channel.

0 Likes 0 · ·
geoff-moore avatar image
geoff-moore answered ·

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

1 comment Share
1 |1000 characters needed characters left characters exceeded

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

Hi Geoff,

Based on our records, there are a small number of customers whose apps are impacted. So we communicated with the account owners about the changes. Do you mind to provide me with your account id (or main company number) so I can check the reason why you were not informed?

Meanwhile, we are updating the dev guide and the API reference to reflect the changes.

My apologies for any inconvenience regarding this aspect.

0 Likes 0 · ·

Write an Answer

Hint: Notify or tag a user in this post by typing @username.

Up to 10 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.