Spécifier les détails de connexion à un point d'extrémité REST dans un fichier JSON

Avant de créer une connexion à partir d'Oracle Analytics Cloud vers les points d'extrémité REST d'une source de données, créez un fichier JSON compressé contenant les détails de la connexion.

Vous pouvez télécharger un modèle JSON à partir de la Bibliothèque publique Oracle Analytics. Stockez les détails de connexion dans un fichier JSON basé sur le modèle, puis compressez le fichier JSON au format ZIP. Vous pouvez également télécharger des exemples de fichiers JSON pour un ensemble d'applications de logiciel-service ou de plate-forme-service.

Format du modèle JSON pour la connexion à des points d'extrémité 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"
    }
}

Exemple JSON pour la connexion à des points d'extrémité 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"
    }
}

À propos de l'authentification OAuth2

Avant de commencer, assurez-vous que votre source de données cibles prend en charge l'authentification OAuth2. Cette authentification n'est pas prise en charge par toutes les sources de données.

Lorsque vous créez le fichier JSON à l'aide d'un des modèles téléchargés, spécifiez le type d'authentification approprié dans le champ authentication-type.

Types OAuth2 Valeurs valides pour le champ authentication-type.
Code OAuth2 OAuth2Code
Données d'identification de mot de passe OAuth2 OAUTH2PasswordGrant
OAuth2 implicite OAUTH2ImplicitGrant
Données d'identification de client OAuth2 OAUTH2ClientCredentials

Dans cet exemple, la méthode d'authentification Données d'identification de mot de passe Auth2 est spécifiée à l'aide de la valeur "OAUTH2PasswordGrant" pour authentication-type.
Description de GUID-4642572E-DC9E-4D96-BB92-73FBD9274BC3-default.png ci-après
.png

Autres conseils relatifs à la création du fichier JSON

  • Supprimez les paramètres et les valeurs inutiles du fichier.
  • Assurez-vous que le type d'authentification est réglé à noauth, BasicAuth, HttpHeader ou à une des valeurs OAuth2 du tableau ci-dessus.