Specificarea detaliilor conexiunii la punctele finale REST într-un fişier JSON

Înainte de a crea o conexiune din Oracle Analytics Cloud la punctele finale REST ale unei surse de date, creaţi un fişier JSON arhivat, care să conţină detaliile conexiunii. Asiguraţi-vă că sursa de date poate genera date în format JSON.

Puteţi descărca un şablon JSON de la Oracle Analytics Public Library. Stocaţi detaliile conexiunii într-un fişier JSON, pe baza şablonului, apoi comprimaţi fişierul JSON în format ZIP. De asemenea, puteţi descărca exemple de fişiere JSON pentru o gamă de aplicaţii SaaS şi PaaS.

Şablon cu formatul fişierului JSON pentru conexiunea la punctele finale 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"
    }
}

Exemplu de fişier JSON pentru conexiunea la punctele finale REST ale 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"
    }
}

Despre autentificarea OAuth2

Înainte de a începe, asiguraţi-vă că sursa de date destinaţie acceptă autentificarea OAuth2; nu toate sursele de date acceptă OAuth2.

Când creaţi fişierul JSON utilizând unul dintre şabloanele descărcate, specificaţi tipul de autentificare adecvat în câmpul authentication-type.

Tipuri OAuth2 Valori valide pentru câmpul authentication-type.
Cod OAuth2 OAuth2Code
Acreditări pentru parolă OAuth2 OAUTH2PasswordGrant
OAuth2 implicit OAUTH2ImplicitGrant
Acreditări client OAuth2 OAUTH2ClientCredentials

În acest exemplu, metoda de autentificare Acreditări pentru parolă OAuth2 este specificată utilizând "OAUTH2PasswordGrant" drept valoarea pentru authentication-type.
Urmează descrierea GUID-4642572E-DC9E-4D96-BB92-73FBD9274BC3-default.png
.png

Alte sfaturi despre crearea fişierului JSON

  • Eliminaţi din fişier parametrii şi valorile care nu sunt necesare.
  • Asiguraţi-vă că valoarea pentru Tip de autentificare este setată la noauth, BasicAuth, HttpHeader sau una dintre setările pentru OAuth2 din tabelul de mai sus.