﻿<?xml version="1.0" encoding="utf-8"?>
<!--
	RingCentral REST connection manager definitions.
	Copyright © 2006-2022 COZYROC LLC. All rights reserved.
-->
<ConnectionManager Name="RingCentral" RuntimeVersion="2.1" Help="http://www.cozyroc.com/ssis/ringcentral-connection" xmlns="http://www.cozyroc.com/schema/rcm-config-1.0.xsd">
	<Service EndPoint="https://platform.[Host].ringcentral.com/restapi/v1.0" />

	<Authentication Name="OAuth 2">
		<Documentation>https://developers.ringcentral.com/api-reference/authentication</Documentation>

		<User>
			<Parameter Name="client_id">
				<Documentation>Required. Specify application client id.</Documentation>
			</Parameter>
			<Parameter Name="client_secret">
				<Documentation>Required. Specify application client secret.</Documentation>
			</Parameter>
			<Parameter Name="redirect_uri">
				<Documentation>Required. Specify redirect uri associated with the app.</Documentation>
			</Parameter>
		</User>

		<Test Url="/dictionary/permission" />

		<Token Url="{{=new Uri(connection.serverHost).authority()}}/restapi/oauth/authorize" Result="{{=response.access_token}}">
			<Parameters>
				<Parameter Name="response_type" Value="code" />
				<Parameter Name="client_id" Value="{{=token.client_id}}" />
				<Parameter Name="redirect_uri" Value="{{=token.redirect_uri}}" />
				<Parameter Name="state" Value="{{=Math.random()}}" />
			</Parameters>

			<Authorized Id="{{=token.redirect_uri}}" Result="{{=
				connection.execute({
					url: new Uri(connection.serverHost).authority() + '/restapi/oauth/token',
					method: 'POST',
					headers: { Authorization : 'Basic' + Base64.encode(token.client_id + ':' + token.client_secret) },
					parameters: {
						code: response.code,
						client_id: token.client_id,
						grant_type: 'authorization_code',
						redirect_uri: token.redirect_uri
				} })}}" />

			<Refresh Url="{{=new Uri(connection.serverHost).authority()}}/restapi/oauth/token" Method="POST" Result="{{=response.refresh_token}}" Expiration="{{=Date.now() + (response.expires_in - 300) * 1000}}">
				<Documentation>https://developers.ringcentral.com/api-reference/Get-Token#section-refresh-token-flow</Documentation>

				<Parameters>
					<Parameter Name="Authorization" Value="{{=Base64.encode(token.client_id + ':' + token.client_secret)}}" Type="HttpHeader" />
					<Parameter Name="grant_type" Value="refresh_token" />
					<Parameter Name="refresh_token" Value="{{=token.Refresh}}" />
				</Parameters>
			</Refresh>
		</Token>

		<Parameters>
			<Parameter Name="Authorization" Value="Bearer {{=token.Access}}" Type="HttpHeader" />
		</Parameters>
	</Authentication>

	<Resources>
		<Template>
			<Field Name="ShortText" DataType="DT_WSTR" Length="255" />
			<Field Name="LongText" DataType="DT_WSTR" Length="1000" />
			<Field Name="DateTime" DataType="DT_DBTIMESTAMP" />
			<Field Name="Date" DataType="DT_DBDATE" />

			<Resource Name="Base">
				<Read Result="{{=response}}">
					<Parameters>
						<Parameter Name="page" Value="{{=parameters.iterator}}" />
						<Parameter Name="per_page" Value="{{=parameters.batchSize}}" />
						<Parameter Name="_includeUserParameters" Value="{{=parameters}}" />
					</Parameters>

					<Iterator>
						<Next Value="{{=parseInt(parameters.iterator || 0) + 1}}" />
					</Iterator>
				</Read>

				<Create Method="POST">
					<Parameters>
						<Parameter Name="application/json" Value="{{=item}}" Type="Body" />
						<Parameter Name="_includeUserParameters" Value="{{=parameters}}" />
					</Parameters>
				</Create>

				<Update Method="PUT">
					<Parameters>
						<Parameter Name="application/json" Value="{{=item}}" Type="Body" />
						<Parameter Name="_includeUserParameters" Value="{{=parameters}}" />
					</Parameters>
				</Update>

				<Delete Method="DELETE"/>
			</Resource>
		</Template>

	</Resources>
	<Script>
		<Module Name="Main">
			<![CDATA[
require('underscore');
require('base64');
require('Uri');

]]>
		</Module>
	</Script>
</ConnectionManager>