vb avatar image
vb posted Phong Vu commented

Generating Access token and refresh token and efficiently using them

Most of the developers come across the issue of how to handle access token and refresh token renewal process. Here is an efficient way of handling these issues.

Access token lifetime is 3600s = 1 hour
Refresh token lifetime is 7 days(1 week)

There are 2 ways to handle the renewal process:

1. Renew access token and refresh token for every 1 hour. The expires_at  time provides allows you to know when you need to refresh a token and regularly checking it will allow you to refresh it as and when required. Also, you should detect when any RingCentral API you are calling returns an HTTP Status Code 401 (Unauthorized).
        You can refresh a token that is not expired. The previous access token will be immediately purged and a new access token will be returned. There will only ever be one active access token at a time for each instance. The only downside is the time it takes to issue those refresh commands, so we don't recommend refreshing tokens constantly as it will slow down your app.

2.  If you cant change the app as mentioned above (for instance, if the app is stateless and you cannot store access/refresh tokens), you should pass refresh_token_ttl=0 parameter along with /oauth/token API so that refresh tokens are expired immediately after creation.

We provide the developers with SDKs for Javascript, PHP and python which will automatically handle reusing of tokens across instances. You can find the SDKs and documentations here:

1 |1000

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

rob-admin7660 avatar image rob-admin7660 commented ·
This is not a great developer experience. We deal with a lot of cloud marketing data platforms, and none of them have such a rigorous authentication process.

For instance, Facebook tokens are valid for 60 days for users and indefinitely for businesses. Twitter tokens do not expire. A 1 hour expiration with a 1 week deadline for refresh tokens is just hostile to platform developers and unhelpful.

This is business phone call data we're dealing with here, not Top Secret security data.
1 Like 1 ·
lee avatar image lee rob-admin7660 commented ·
Totally agree. My experience with this API has been one of frustration compared to others.

The fact I have to have my end users authenticate with RingCentral instead of allowing me as a super admin via server side only on some features is also annoying the hell out of my end users.

I'm integrated with other platforms like RightSignature and it's so much easier. Thank god not every service requires this. If I had known of these issues (even after using the dev platform some problems I didn't find until we went live) I would not have moved off our old internal phone system this year.

While the API team is very responsive to questions and even personally contacted me to help resolve a major issue I was having they do seem to be short staffed if they can't push out updates in a timely manner. It's been over a year for an issue that was first reported (at least publicly on this forum) of not being able to set the caller id on RingOut (except a crazy work around of setting the extension caller id and then having to update it back again after the call connects).
0 Likes 0 ·
rick-smith2386 avatar image rick-smith2386 rob-admin7660 commented ·
Could not agree more, I have worked with Twilio and had things up in running in 30mins or so...Get with it RC!
0 Likes 0 ·
ben-carpenter13516 avatar image ben-carpenter13516 commented ·
I'm testing this on my own system, and it appears even after a refresh, I can still use the old Access token until it hits its original expiration date. Is that how it's supposed to work?

I just want to make sure that if someone makes a call right when a refresh is occurring such that they grab the existing Access Token, then the refresh occurs, then they actually make the API call, it won't error out.
0 Likes 0 ·
Phong Vu avatar image Phong Vu ♦♦ ben-carpenter13516 commented ·
I think getting a new access token by using a refresh token will not automatically revoke the old access token it it's not expired. You should always check if the access token expires, then use the refresh token to get a new access token.

If the access token is still valid while you request for a new access token, you can call the revoke token endpoint to revoke the old access token.

Using RingCentral SDKs would be the most convenient way to handle authentication. Check out these tutorials to see if you can use in your app.


Python SDK:


+ Phong
0 Likes 0 ·
ben-carpenter13516 avatar image ben-carpenter13516 ben-carpenter13516 commented ·
Thanks, Phong.

I'm going to discuss our particular situation (developing in C#, running multiple WebAPI instances with a multi-user environment) directly with my RingCentral technical contact, and if anything interesting comes up, I'll post it here in case anyone else has the same situation.
0 Likes 0 ·



vb contributed to this article