Zadanie detailov pripojenia koncového bodu REST v súbore JSON

Pred vytvorením pripojenia zo služby Oracle Analytics Cloud ku koncovým bodom REST dátového zdroja vytvorte skomprimovaný súbor JSON, ktorý bude obsahovať detaily pripojenia.

Šablónu JSON si môžete stiahnuť v časti Oracle Analytics Public Library. Uložte detaily pripojenia v súbore JSON založenom na šablóne a potom súbor JSON skomprimujte do formátu ZIP. Môžete si stiahnuť aj príklady súborov JSON pre viaceré aplikácie SaaS a PaaS.

Formát šablóny JSON pre pripojenie ku koncovým bodom 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"
    }
}

Príklad súboru JSON pre pripojenie ku koncovým bodom REST služby 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"
    }
}

Autentifikácia OAuth2

Skôr než začnete, uistite sa, že cieľový dátový zdroj podporuje autentifikáciu OAuth2, pretože nie všetky dátové zdroje podporujú OAuth2.

Pri vytváraní súboru JSON pomocou niektorej zo stiahnutých šablón zadajte zodpovedajúci typ autentifikácie do poľa authentication-type.

Typy OAuth2 Platné hodnoty pre pole authentication-type.
Kód OAuth2 OAuth2Code
Doklady hesla OAuth2 OAUTH2PasswordGrant
Implicitné OAuth2 OAUTH2ImplicitGrant
Doklady klienta OAuth2 OAUTH2ClientCredentials

V tomto príklade je zadaná metóda autentifikácie Doklady hesla OAuth2 pomocou hodnoty OAUTH2PasswordGrant v poli authentication-type.
Popis GUID-4642572E-DC9E-4D96-BB92-73FBD9274BC3-default.png je uvedený nižšie
.png

Ďalšie tipy pre vytvorenie súboru JSON

  • Zo súboru odoberte nepotrebné parametre a hodnoty.
  • Uistite sa, že pre typ autentifikácie je nastavená hodnota noauth, BasicAuth, HttpHeader alebo niektoré z nastavení OAuth2 v tabuľke vyššie.