Optional urlPrefix and apiVersion for Platform.createUrl. (#95)

3.2.0
* Optional urlPrefix and apiVersion for Platform.createUrl.
* Assertions for new urlPrefix and apiVersion options of platform.createUrl.
* Introducing Platform._knownPrefixes.

Author: MostFrumiousBandersnatch

build/ringcentral.js

@@ -1,6 +1,6 @@
 {
   "name": "ringcentral",
-  "version": "3.1.3",
+  "version": "3.2.0",
   "scripts": {
     "clean": "rm -rf build/*",
     "build": "npm run clean && webpack --display-modules --progress --colors --bail",

build/ringcentral.js.map

@@ -411,6 +411,10 @@ describe('RingCentral.platform.Platform', function() {
                 addMethod: 'POST'
             })).to.equal('http://whatever/restapi/v1.0/foo?bar&_method=POST&access_token=ACCESS_TOKEN');
 
+            expect(platform.createUrl('/rcvideo/v1/foo?bar', {
+                addServer: true,
+                addToken: true,
+            })).to.equal('http://whatever/rcvideo/v1/foo?bar&access_token=ACCESS_TOKEN');
         }));
 
     });

build/ringcentral.min.js

@@ -78,6 +78,10 @@ function Platform(options) {
     /** @private */
     this._client = options.client;
 
+    /** @private */
+    this._knownPrefixes = options.knownPrefixes || Platform._knownPrefixes;
+
+
     /** @private */
     this._refreshPromise = null;
 
@@ -92,6 +96,7 @@ function Platform(options) {
 
 Platform._urlPrefix = '/restapi';
 Platform._apiVersion = 'v1.0';
+Platform._knownPrefixes = ['/rcvideo'];
 Platform._tokenEndpoint = '/restapi/oauth/token';
 Platform._revokeEndpoint = '/restapi/oauth/revoke';
 Platform._authorizeEndpoint = '/restapi/oauth/authorize';
@@ -135,11 +140,16 @@ Platform.prototype.createUrl = function(path, options) {
     options = options || {};
 
     var builtUrl = '',
-        hasHttp = path.indexOf('http://') != -1 || path.indexOf('https://') != -1;
+        hasHttp = path.indexOf('http://') != -1 || path.indexOf('https://') != -1,
+        alreadyPrefixed = this._knownPrefixes.some(function(prefix) {
+            return path.indexOf(prefix) === 0;
+        });
 
     if (options.addServer && !hasHttp) builtUrl += this._server;
 
-    if (path.indexOf(Platform._urlPrefix) == -1 && !hasHttp) builtUrl += Platform._urlPrefix + '/' + Platform._apiVersion;
+    if (path.indexOf(Platform._urlPrefix) == -1 && !hasHttp && !alreadyPrefixed) {
+        builtUrl += Platform._urlPrefix + '/' + Platform._apiVersion;
+    }
 
     builtUrl += path;