question

rich-sutton14968 avatar image
rich-sutton14968 asked Phong Vu commented

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
Toggle Comment visibility. Current Visibility: Viewable by all users

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

rich-sutton14968 avatar image rich-sutton14968 commented ·

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 ·

4 Answers

·
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.

1 |1000
Toggle Comment visibility. Current Visibility: Viewable by all users

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

rich-sutton14968 avatar image
rich-sutton14968 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.

1 |1000
Toggle Comment visibility. Current Visibility: Viewable by all users

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

rich-sutton14968 avatar image
rich-sutton14968 answered Phong Vu commented

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
1 |1000
Toggle Comment visibility. Current Visibility: Viewable by all users

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

Phong Vu avatar image Phong Vu ♦♦ commented ·

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

0 Likes 0 ·
geoff-moore15713 avatar image
geoff-moore15713 answered Phong Vu commented

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

1 comment
1 |1000
Toggle Comment visibility. Current Visibility: Viewable by all users

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

Phong Vu avatar image Phong Vu ♦♦ commented ·

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.