Skip to content

ringcentral/engage-voice-api-docs

Repository files navigation

RingCentral RingCX API Docs

Specs Status Docs Status Docs Status

This repository is the home of the RingCentral RingCX Developer Guide: a collection of materials, and documentation to help educate developers on how to build on top of the RingCentral RingCX platform.

Visit at: https://engage-voice-api-docs.rtfd.org

Contributing

If you would like to contribute to the RingCentral documentation effort, fork this repository, make your desired edits and contributions, and issue a pull request accordingly.

Running ReadTheDocs Locally

% git clone https://github.com/ringcentral/engage-voice-api-docs.git
% cd engage-voice-api-docs
% pip install mkdocs
% pip install mkdocs-ringcentral
% pip install markdown-include
% mkdocs serve

Then you should be able to load http://localhost:8000 to view the documentation.

Testing OpenAPI Specs

This repo holds OpenAPI specs for RingCX. For each commit, tests are run on Travis CI to verify that the OpenAPI 3.0 specs validate.

You can verify the specs locally with the following if you have Go installed.

% git clone https://github.com/ringcentral/engage-voice-api-docs.git
% cd engage-voice-api-docs
% go test -v ./...

If you wish to change the specs being tested edit the specs_test.go file.