Angive forbindelsesdetaljer for REST-slutpunkt i en JSON-fil

Før du opretter en forbindelse fra Oracle Analytics Cloud til en datakildes REST-slutpunkter, skal du oprette en zippet JSON-fil med forbindelsesdetaljerne.

Du kan downloade en JSON-skabelon fra Oracle Analytics Public Library. Gem forbindelsesdetaljerne i en JSON-fil, der er baseret på skabelonen, og komprimer derefter JSON-filen i ZIP-format. Du kan også downloade eksempler på JSON-filer til en række SaaS- og PaaS-applikationer.

JSON-skabelonformat for forbindelse til REST-slutpunkter

{
    "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-eksempel for forbindelse til REST-slutpunkter for 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"
    }
}

Om OAuth2-autentificering

Før du starter, skal du sørge for, at din måldatakilde understøtter OAuth2-autentificering. Ikke alle datakilder understøtter OAuth2.

Når du opretter JSON-filen ved hjælp af en af de downloadede skabeloner, skal du angive den relevante autentificeringstype i feltet authentication-type.

OAuth2-typer Gyldige værdier for feltet authentication-type.
OAuth2-kode OAuth2Code
Legitimationsoplysninger for OAuth2-adgangskode OAUTH2PasswordGrant
Implicit OAuth2 OAUTH2ImplicitGrant
Legitimationsoplysninger for OAuth2-klient OAUTH2ClientCredentials

I dette eksempel er autentificeringsmetoden Legitimationsoplysninger for OAuth2-adgangskode angivet ved hjælp af "OAUTH2PasswordGrant" som værdien for authentication-type.
Beskrivelse af GUID-4642572E-DC9E-4D96-BB92-73FBD9274BC3-default.png følger
.png

Andre tip til oprettelse af JSON-filen

  • Fjern unødvendige parametre og værdier fra filen.
  • Sørg for, at værdien for autentificeringstypen er angivet til noauth, BasicAuth, HttpHeader eller en af OAuth2-indstillingerne i tabellen ovenfor.