Naviga Subscribe API
Naviga
  • Subscribe API
  • Payments API
    • Migration to Payments API
      • Apply Payment
      • EZPay Sign Up
      • Update EZPay Info
      • Restart
      • Create Payment Method
      • Get Payment Method by Id
      • Add Tip
  • Users Orchestrator API
    • Migration to UsersOrchestrator API
      • Get By Id
      • Get By Email
      • Get By Query String
      • Get By Encrypted Email
      • Get By Encrypted Id
      • Get By Token
      • Create User
      • Create Passwordless User
      • Update User
      • Update Password
      • Update Email
      • Authenticate/Authenticate By Token
      • ForgotPassword
      • Verify Email
      • Send Verification Code
  • Entitlements Orchestrator API
    • Migration to EntitlementsOrchestrator API
      • Access
Powered by GitBook
LogoLogo

COPYRIGHT © 2024 NAVIGA

On this page
  • Digital Access
  • Introduction
  • Comparison
  • Digital Access
  • Get Access
  • Introduction
  • Comparison
  • Get Access
Export as PDF
  1. Entitlements Orchestrator API
  2. Migration to EntitlementsOrchestrator API

Access

Digital Access

Introduction

This endpoint is used to create Digital Access for the User based on the provided EntitlementCode and CustomerRegistrationId and create an Access Log record in the database.

Comparison

Note: The old model is in PascalCase, while the new model is in CamelCase.

Entitlements API
Entitlements Orchestrator API

URL

/DigitalAccess

/v4/Access

Method

POST

POST

Request

Response

Note:– The parameters subscriptionId and accessLevelCode are available only from version 3.17.0.3 onwards.


Digital Access

POST /v4/Access

This endpoint is used to create Digital Access for the User based on the provided EntitlementCode and CustomerRegistrationId and create an Access Log record in the database.

Note: The parameters marked with an asterisk (*) are mandatory and must be included in the input model.

Headers

Name
Type
Description

Authorization*

String

JSON Web Token used for security purposes

X-SourceSystem*

String

To identify the consumer or the Source System

X-ClientCode*

String

Client Code of the Tenant

X-PaperCode*

String

Paper Code of the Tenant

X-ClientGroupCode*

String

Client Group Code of the Tenant

Request Body

Name
Type
Description

EntitlementCode*

String

Unique identifier of the Entitlement in the SubCon database

CustomerRegistrationId*

String

Unique identifier of the Registration in the SubCon database.

Device*

String

Caller’s Device

ReturnUrl

String

URL to which users must be redirected after the access has been created.

FromUrl

String

URL to which users will be directed to create access.

{
  "message":{
      "code": "EntitlementsOrchestrator_S200_01",
      "text": "Access Success.",
      "type": "Success"
  },
  "data": {
    "accessId": 1,
    "eEditionUrl": "url",
    "subscriptionId": 0,
    "accessLevelCode": "string"
  }
}

Note:– The parameters subscriptionId and accessLevelCode are available only from version 3.17.0.3 onwards.

Status Code
Code
Message

400

EntitlementsOrchestrator_E400

Bad Request

400

EntitlementsOrchestrator_E400_01

Invalid InputModel

400

EntitlementsOrchestrator_E400_02

Entitlements not found

400

EntitlementsOrchestrator_E400_03

AccessLevelCode is Purchase

400

EntitlementsOrchestrator_E400_04

AccessLevelCode is Upgrade

400

EntitlementsOrchestrator_E400_05

AccessLevelCode is not Premium

500

EntitlementsOrchestrator_E500

Internal Server Error

500

EntitlementsOrchestrator_E500_01

TemporaryEntitlement doesn't exist.

500

EntitlementsOrchestrator_E500_02

EntitlementAccess doesn't exist.

500

EntitlementsOrchestrator_E500_03

Entitlement's eEdition Url was not found.

Get Access

Introduction

This endpoint is used to return the current access level (Premium, Upgrade, Purchase) based on the provided EntitlementCode and CustomerRegistrationId.

Note:– The GET method creates an entry in the Access_log table only from version 3.17.0.3 onwards.

Comparison

Note: The old model is in PascalCase, while the new model is in CamelCase.

Entitlements API
Entitlements Orchestrator API

URL

/DigitalAccess

/v4/Access?CustomerRegistrationId={string}&EntitlementCode={string}

Method

POST

GET

RequestBody

Response


Get Access

GET /v4/Access?CustomerRegistrationId={string}&EntitlementCode={string}

This endpoint is used to return the current access level (Premium, Upgrade, Purchase) based on the provided EntitlementCode and CustomerRegistrationId.

Note: The parameters marked with an asterisk (*) are mandatory and must be included in the input model.

Query Parameters

Name
Type
Description

EntitlementCode*

String

Unique identifier of the Entitlement in the SubCon database

CustomerRegistrationId*

String

Unique identifier of the Registration in the SubCon database.

Headers

Name
Type
Description

Authorization*

String

JSON Web Token used for security purposes

X-SourceSystem*

String

To identify the consumer or the Source System

X-ClientCode*

String

Client Code of the Tenant

X-PaperCode*

String

Paper Code of the Tenant

X-ClientGroupCode*

String

Client Group Code of the Tenant

{
  "message":{
      "code": "EntitlementsOrchestrator_S200_01",
      "text": "Access Success.",
      "type": "Success"
  },
  "data": {
    "registrationId": 1,
    "subscriptionId": 1,
    "accessLevelCode": "Premium"
  }
}

Status Code
Code
Message

400

EntitlementsOrchestrator_E400

Bad Request

400

EntitlementsOrchestrator_E400_01

Invalid InputModel

400

EntitlementsOrchestrator_E400_02

Entitlements not found

500

EntitlementsOrchestrator_E500

Internal Server Error

PreviousMigration to EntitlementsOrchestrator API

Last updated 7 months ago

{
  "CustomerRegistrationId": "string",
  "InstantAccessEventId": 0,
  "EntitlementCode": "string",
  "Device": "string",
  "FromUrl": "string",
  "ReturnUrl": "string",
  "IsAccess": true
}
{
  "customerRegistrationId": "string",
  "entitlementCode": "string",
  "device": "string",
  "fromUrl": "string",
  "returnUrl": "string"
}
{
  "Code": 0,
  "Errors": [
    {
      "Message": "string",
      "Code": "string",
      "Type": {
        "Id": 0,
        "Code": "string"
      },
      "ErrorSource": "string"
    }
  ],
  "Result": {
    "IsAuthorized": true,
    "eEditionUrl": "string",
    "AccessLevel": "string",
    "Token": "string"
  },
  "SessionId": "string",
  "RequestId": "string"
}
{
  "message": {
    "code": "string",
    "text": "string",
    "type": 0
  },
  "meta": "string",
  "data": {
    "accessId": 0,
    "eEditionUrl": "string",
    "subscriptionId": 0,
    "accessLevelCode": "string"
  }
}
{
  "CustomerRegistrationId": "string",
  "InstantAccessEventId": 0,
  "EntitlementCode": "string",
  "Device": "string",
  "FromUrl": "string",
  "ReturnUrl": "string",
  "IsAccess": true
}
{
  "Code": 0,
  "Errors": [
    {
      "Message": "string",
      "Code": "string",
      "Type": {
        "Id": 0,
        "Code": "string"
      },
      "ErrorSource": "string"
    }
  ],
  "Result": {
    "IsAuthorized": true,
    "eEditionUrl": "string",
    "AccessLevel": "string",
    "Token": "string"
  },
  "SessionId": "string",
  "RequestId": "string"
}
{
  "message": {
    "code": "string",
    "text": "string",
    "type": 0
  },
  "meta": "string",
  "data": {
    "customerRegistrationId": "string",
    "subscriptionId": 0,
    "accessLevelCode": "string"
  }
}