OpenAPI 3 (2600hz#5840)

* convert json schemas to oas3 schema

* forgot to add kazoo keywords

* some changes in printing the report

* fix some minor issues

* oas3 deep flatten

* wip

* kz yaml

* kz-yaml: wip

* got multi line work mostly

* kz_yam: fix block indent indicator, encoding and add missing seq indicator

* Debugging

* getting there

* fix fold_string, remove comments and revert drop and indent change

* add tests for kz-yaml, update deps to fix the library bug

* add decode/encode all

* fix ast api endpoints

* u dun sort biggy map?

* add key string style

* more fixes

* move swagger schema definitions to its own module

* format as endpoint centric

* run make apis

* syncing

* fix some compilation issue

* set app name correctly

* don't deep check items

* save oas 3 paths too, some adjustments, add specs

* add oas3 paths

* dialyzing

* use best string style in kz_yaml

* path?

* bump copyright year

* creating valid openapi

* create versioned parameters

* don't add requestBody if has no schema

* look into items when generating oas3 schemas

* multi ref is not allowed in json reference

* actuallt we dont need component, we're refrecing directly to the file

* generate operation object, add id and tag

* build opeanapi spec files

* make fmt

* lieu of ?MODULE

* make apis

* revert kz_maps

* well after all it was a bug in encoder not the library

* use forked repo as dep

applications/callflow/doc/notification.md

@@ -15,7 +15,7 @@ Key | Description | Type | Default | Required | Support Level
 `comments` | Text message that need to include into notification | `string()` |   | `false` |  
 `notification_media.[]` |   | `string('email' | 'sms')` |   | `false` |  
 `notification_media` | What is media need to use for notification | `array(string('email' | 'sms'))` |   | `false` |  
-`recipients.[].id` | The email address/user ID or the list of email addresses/user IDs based on specified type | `string() | array()` |   | `true` |  
+`recipients.[].id` | The email address/user ID or the list of email addresses/user IDs based on specified type | `string() | array(string())` |   | `true` |  
 `recipients.[].type` | Controls if the ID of this object is a Kazoo user ID or an email address | `string('user' | 'email')` |   | `true` |  
 `recipients` | One or more specific email addresses, Kazoo user ids or a combination of both | `array(object())` | `[]` | `true` |  
 `send_at` | Defines when send customer defined notification. For `callflow_exec` value notifications is send during callflow execution. For `channel_destroy` value notification is send after channel(bridge) is destroyed | `string('callflow_exec' | 'channel_destroy')` | `channel_destroy` | `false` |  

applications/callflow/doc/ref/notification.md

@@ -13,7 +13,7 @@ Key | Description | Type | Default | Required | Support Level
 `comments` | Text message that need to include into notification | `string()` |   | `false` |  
 `notification_media.[]` |   | `string('email' | 'sms')` |   | `false` |  
 `notification_media` | What is media need to use for notification | `array(string('email' | 'sms'))` |   | `false` |  
-`recipients.[].id` | The email address/user ID or the list of email addresses/user IDs based on specified type | `string() | array()` |   | `true` |  
+`recipients.[].id` | The email address/user ID or the list of email addresses/user IDs based on specified type | `string() | array(string())` |   | `true` |  
 `recipients.[].type` | Controls if the ID of this object is a Kazoo user ID or an email address | `string('user' | 'email')` |   | `true` |  
 `recipients` | One or more specific email addresses, Kazoo user ids or a combination of both | `array(object())` | `[]` | `true` |  
 `send_at` | Defines when send customer defined notification. For `callflow_exec` value notifications is send during callflow execution. For `channel_destroy` value notification is send after channel(bridge) is destroyed | `string('callflow_exec' | 'channel_destroy')` | `channel_destroy` | `false` |