Especificación de los detalles de conexión de punto final de REST en un archivo JSON

Antes de crear una conexión desde Oracle Analytics Cloud a puntos finales de REST de un origen de datos, cree un archivo JSON comprimido que contenga los detalles de la conexión.

Puede descargar una plantilla JSON desde Biblioteca pública de Oracle Analytics. Almacene los detalles de la conexión en un archivo JSON basado en la plantilla y, a continuación, comprima el archivo JSON en formato ZIP. También puede descargar archivos JSON de ejemplo para una serie de aplicaciones SaaS y PaaS.

Formato de plantilla JSON para la conexión a puntos finales de 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"
    }
}

Ejemplo de JSON para la conexión a puntos finales de REST de 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"
    }
}

Acerca de la autenticación OAuth2

Antes de empezar, asegúrese de que el origen de datos de destino soporta la autenticación OAuth2; no todos los orígenes de datos soportan OAuth2.

Al crear el archivo JSON mediante una de las plantillas descargadas, especifique el tipo de autenticación adecuado en el campo authentication-type.

Tipos de OAuth2 Valores válidos para el campo authentication-type.
Código OAuth2 OAuth2Code
Credenciales de contraseña OAuth2 OAUTH2PasswordGrant
OAuth2 implícito OAUTH2ImplicitGrant
Credenciales de Cliente de OAuth2 OAUTH2ClientCredentials

En este ejemplo, el método de autenticación Credenciales de contraseña OAuth2 se especifica utilizando "OAUTH2PasswordGrant"como valor de authentication-type.
A continuación se muestra la descripción de GUID-4642572E-DC9E-4D96-BB92-73FBD9274BC3-default.png
.png

Otros consejos sobre la creación del archivo JSON

  • Elimine parámetros y valores innecesarios del archivo.
  • Asegúrese de que el valor de tipo de autenticación esté definido en noauth, BasicAuth, HttpHeader o en uno de los valores de OAuth2 de la tabla anterior.