News & Announcements User Community Developer Community

Welcome to the RingCentral Community

Please note the community is currently under maintenance and is read-only.

Search
Make sure to review our Terms of Use and Community Guidelines.
  Please note the community is currently under maintenance and is read-only.
Home » Developers
RingCentral XML REST API End Of Life on Nov 30, 2017
Tags: rest api
Aug 17, 2017 at 10:37am   •   0 replies  •  0 likes
John Wang

Disclaimer: This FAQ was developed to complement and provide more information about the end-of-life notification for RingCentral XML REST API. If you have further questions, contact Support or your Account Manager to learn more about the most recent release of the REST API.


Frequently Asked Questions


Q: What exactly does XML REST API end-of-life mean?


A: End-of-life means that after November 30th, 2017, RingCentral Platform API will no longer respond to API requests using or requesting XML. Specifically, the RingCentral REST API will not accept requests or return responses using the "application/xml" MIME type or "Content-Type: application/xml" and "Accept: application/xml" HTTP header. The JSON format will still be supported and is discussed more below.


Q: Why is RingCentral Platform no longer supporting XML?


A: XML request and responses have been an unofficial and undocumented feature of the API, however, as we continue expand our Cloud Communications and Collaboration services, we've decided to focus our efforts on providing the best APIs using the JSON format instead of the XML format.


Q: When will RingCentral discontinue customer support for XML REST API?


A: Since the XML REST API is an unofficial API today, there is no support today.


Q: What will happen to my applications using the XML REST API after November 30th, 2017?


A: From December 1st, 2017, any applications using XML REST API will receive error responses when sending the XML as the request Content-Type header or Accept header.


Q: What format can I use instead of XML?


A: The RingCentral REST API currently and will continue to formally support and document the JSON format which should be used. The RingCentral Platform API will continue to accept and return JSON message formats. Requests should use the "application/json" MIME type with the "Content-Type: application/json" and "Accept: application/json" HTTP headers. RingCentral API responses will also use the same JSON MIME type and Content-Type header.


Q: What are the benefits of migrating from XML to JSON?


A: Using the JSON format will make your development easier and faster because it is the official format RingCentral uses for documentation, SDKs and support. For statically typed languages, RingCentral SDKs provide typed model classes based on our Open API specification.


Q: Whom should I contact if I have more questions?


A: You can reach us with questions on RingCentral at our Developer Community, https://devcommunity.ringcentral.com, or you can contact RingCentral Developer Support at devsupport@ringcentral.com.



A new Community is coming to RingCentral!

Posts are currently read-only as we transition into our new platform.

We thank you for your patience
during this downtime.

Try Workflow Builder

Did you know you can easily automate tasks like responding to SMS, team messages, and more? Plus it's included with RingCentral Video and RingEX plans!

Try RingCentral Workflow Builder

PRODUCTS
RingEX
Message
Video
Phone
OPEN ECOSYSTEM
Developer Platform
APIs
Integrated Apps
App Gallery
Developer support
Games and rewards

RESOURCES
Resource center
Blog
Product Releases
Accessibility
QUICK LINKS
App Download
RingCentral App login
Admin Portal Login
Contact Sales
© 1999-2024 RingCentral, Inc. All rights reserved. Legal Privacy Notice Site Map Contact Us