تحديد تفاصيل اتصال نقطة نهاية REST في ملف JSON

قبل تكوين اتصال من Oracle Analytics Cloud لنقطة نهاية REST لمصدر بيانات، قم بتكوين ملف JSON مضغوط يحتوي على تفاصيل الاتصال.

يمكنك تنزيل قالب JSON من مكتبة Oracle Analytics العامة. خزن تفاصيل الاتصال في ملف JSON القائم على القالب، ثم اضغط على ملف JSON بتنسيق ZIP. يمكنك أيضًا تنزيل أمثلة ملفات JSON لمجموعة من تطبيقات SaaS وPaaS.

تنسيق قالب JSON للاتصال بنقاط نهاية 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"
    }
}

مثال JSON للاتصال بنقاط نهاية 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"
    }
}

حول تصديق OAuth2

قبل البدء، تأكد من أن مصدر البيانات الهدف يدعم تصديق OAuth2؛ لا يدعم كافة مصادر البيانات OAuth2.

عندما تقوم بتكوين ملف JSON باستخدام أحد القوالب التي تم تنزيلها، حدد نوع التصديق المناسب في حقل نوع التصديق.

أنواع OAuth2 القيم الصالحة لحقل نوع التصديق.
رمز OAuth2 OAuth2Code
صلاحيات كلمة سر OAuth2 OAUTH2PasswordGrant
OAuth2 ضمني OAUTH2ImplicitGrant
صلاحيات عميل OAuth2 OAUTH2ClientCredentials

في هذا المثال، تم تحديد طريقة تصديق بيانات اعتماد كلمة سر OAuth2 باستخدام "OAUTH2PasswordGrant" كقيمة نوع التصديق.
فيما يلي وصف GUID-4642572E-DC9E-4D96-BB92-73FBD9274BC3-default.png
.png

نصائح أخرى حول تكوين ملف JSON

  • قم بإزالة المعلمات والقيم غير الضرورية من الملف.
  • تأكد من تعيين قيمة نوع التصديق على noauth، أو BasicAuth، أو HttpHeader، أو أحد إعدادات OAuth2 في الجدول أعلاه.