question

thomas-costello1592 avatar image
thomas-costello1592 asked Robin Hu commented

5+ API calls per each used endpoint (20+ in total) SNS

5+ API calls per each used endpoint (20+ in total)


What does this mean?


The only permission for the app is SMS.


What are the required "endpoints" that must be demonstrated for successful graduation?

getting started
1 |3000

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

benjamin-dean avatar image
benjamin-dean answered
Hello Thomas,

With the launch of the Developer Journey feature (which provides developers with real-time analytics and production access request criteria validation for each of your applications and is available in the "Status & Review" section for your specific application in the Developer Portal) you can handle most of this self service with a little exploration.

But please allow me to address your questions:

5+ API calls per each used endpoint (20+ in total) 
What does this mean?

Each API Permission in the RingCentral API (such as Read Call Log) is associated with one or more API resources (such as Call Log). This means that for each API Permission you have assigned for your application, you must make at least 5 requests. In cases where you use only a single API permission/resource, you must make at least 20 requests to that particular API. For example let's say your application uses the following permissions:

- Read Accounts
- Read Call Log
- Faxes
- Read Messages

You have to use at least 20 API requests (successfully) in total with an aggregated error response percentage of less than 5%. So you would need to make 5 requests to each of these APIs successfully to have your application meet this criteria to access production.

But if you add an additional API permission, now you have to make 20 (total minimum required) + 5 (new API permission).

Does this make sense?

The only permission for the app is SMS.

Since you're only using SMS, you will need to execute at least 20 successful SMS requests to this endpoint and have less than 5% of those requests be a 4xx error response (1 error per 20 requests = 5%). OAuth requests do not count towards the tally.

What are the required "endpoints" that must be demonstrated for successful graduation?

For an application that ONLY uses the SMS API resource, we would look for the following:

1. A solid description which provides us with the information we need to assess how you plan on using SMS, i.e... will you be sending an SMS to remind customers of an upcoming event -or- are you sending marketing SMS to your customers?

2. We prefer 2 days of solid (simulated production) request volumes from your application, and have a bare minimum of one day of data with at least 20+ requests.

3. Less than 5% of your requests must not be HTTP 4xx error responses.

Of course more successful data, better descriptions, always make it easier for us when we're reviewing the applications weekly on Thursday for production access consideration.


Does all this answer your questions sir?

1 |3000

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

yiru-yao8166 avatar image
yiru-yao8166 answered Robin Hu commented
Hi, 

Please see below of the current status of my endpoint requirement:

The only permission I have is the webhook subscriptions so what are the other endpoints that I will need to request? I have created subscriptions via API and I think that's all I need at this point. Why am I still not passing this requirement?

Thanks!
1 comment
1 |3000

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

Robin Hu avatar image Robin Hu ♦♦ commented ·
Hi Yiru,

You also need to meet total 20+ successful api calls even you only have one endpoint.
0 Likes 0 ·

Developer sandbox tools

Using the RingCentral Phone for Desktop, you can dial or receive test calls, send and receive test SMS or Fax messages in your sandbox environment.

Download RingCentral Phone for Desktop:

Tip: switch to the "sandbox mode" before logging in the app:

  • On MacOS: press "fn + command + f2" keys
  • On Windows: press "Ctrl + F2" keys