Указание сведений о подключении конечной точки REST в файле JSON

Перед созданием подключения из Oracle Analytics Cloud к конечным точкам REST источника данных создайте ZIP-файл JSON, содержащий сведения о подключении.

Шаблон JSON можно выгрузить с веб-страницы Общедоступная библиотека Oracle Analytics. Сохраните сведения о подключении в файле JSON на основе шаблона, затем создайте сжатый файл JSON в формате ZIP. Также можно выгрузить примеры файлов JSON для ряда приложений SaaS и PaaS.

Формат шаблона JSON для подключения к конечным точкам REST

{
    "name": "Connection name",
    "description": "Brief description",
    "baseURL": "URL, e.g. https://api.surveymonkey.com/v3",
    "endpoints": {
        "Endpoint 1": "Endpoint 1 URL, e.g. https://api.surveymonkey.com/v3/users/endpoint1",
        "Endpoint 2": "Endpoint 2 URL, e.g. https://api.surveymonkey.com/v3/question_bank/endpoint2",
        "Endpoint n": "Endpoint n URL, e.g. https://api.surveymonkey.com/v3/users/endpointn"
    },
    "authentication": {
        "type": "Authentication type"
    }
}

Пример JSON для подключения к конечным точкам REST Survey Monkey

{
    "name": "Survey Monkey Connection",
    "description": "Survey Monkey connection",
    "baseURL": "https://api.surveymonkey.com/v3",
    "endpoints": {
        "Users": "https://api.surveymonkey.com/v3/users/me",
        "Questions": "https://api.surveymonkey.com/v3/question_bank/questions"
    },
    "authentication": {
        "type": "HttpHeader"
    }
}

Сведения об аутентификации OAuth2

Прежде чем начать, убедитесь, что целевой источник данных поддерживает аутентификацию OAuth2. Ее поддерживают не все источники данных.

При создании JSON-файла с помощью одного из выгруженных шаблонов укажите соответствующий тип аутентификации в поле authentication-type.

Типы OAuth2 Допустимые значения для поля authentication-type.
Код OAuth2 OAuth2Code
Пароль OAuth2 OAUTH2PasswordGrant
Неявная OAuth2 OAUTH2ImplicitGrant
Учетные данные клиента OAuth2 OAUTH2ClientCredentials

В этом примере метод аутентификации OAuth2 с использованием пароля задается с помощью OAUTH2PasswordGrant в качестве значения authentication-type.
Описание GUID-4642572E-DC9E-4D96-BB92-73FBD9274BC3-default.png ниже
.png
.

Другие советы по созданию файла JSON

  • Удалите из файла ненужные параметры и значения.
  • Убедитесь, что в качестве значения типа аутентификации установлено noauth, BasicAuth, HttpHeader или одна из настроек OAuth2 в таблице выше.