Subscription API

This document is currently being revised

  1. Subscription Panel application loads.

  2. User clicks on either landing or the Subscription Panel calls GET/Offers. Sends offerGroupId and postal code to fetch details.

  3. Subscription Panel then calls POST/subscriptionCost to fetch current taxes and cost.

  4. Subscription Panel calls GET/user to check whether the user already exists. If the user does not already exist, it calls creates the user via POST/user.

  5. User enters the address information. Then, Subscription Panel calls GET/address/standardization to standardize the current address.

  6. Subscription Panel calls POST/Subscriptions/ActiveCheck to check whether this user already has an active subscription. If an active subscription exists, it returns an error.

  7. Subscription Panel renders iframe with the edgil Javascript, which in turn calls:

    • POST/Billing/PaymentSession/StartPaymentSession - opens the iframe and generates a token

    • POST/Billing/PaymentSession/EndPaymentSession - saves credit card information and payment system

  8. User clicks submit in Subscription Panel, and the Subscription Panel calls POST/Subscriptions to create the new subscription.

Offers

GET/Offers - this endpoint checks for the current offers.

Parameters

Parameter Type

Parameter

Data Type

Required?

Description

Header

X-MediaGroupCode

string

Y

Code that designates the circulation system.

Header

X-ClientCode

string

Y

Code that designates the client.

Header

X-PaperCode

string

Y

Code that designates the newspaper.

Header

X-SourceSystem

string

Y

Code that designates the application.

Header

Authorization

string

Y

Authorization token.

Header

X-RequestId

integer

Y

Defines where to look for the user. 1 = User Provider; 2 = Naviga's database; 0 User provider and Naviga's database (recommended)

Query string

postalCode

integer

Y

Postal code

Query string

request.offerGroupId

integer

Y

Offer Group ID

Request example

The following is a cURL request example:

Response example

The following is a json example response from the /Offers endpoint.

Subscription cost

POST/subscription/cost - the checks the current cost and tax for a particular offer

Parameters

Parameter Type

Parameter

Data Type

Required?

Description

Header

X-MediaGroupCode

string

Y

Code that designates the circulation system.

Header

X-ClientCode

string

Y

Code that designates the client.

Header

X-PaperCode

string

Y

Code that designates the newspaper.

Header

X-SourceSystem

string

Y

Code that designates the application.

Header

Authorization

string

Y

Authorization token.

Header

X-RequestId

integer

Y

Defines where to look for the user. 1 = User Provider; 2 = Naviga's database; 0 User provider and Naviga's database (recommended)

Request body

integer

Y

JSON object (see request example below).

Request example

The following is a cURL request example:

Response example

The following is a json example response from the Subscriptions/Cost endpoint:

User information

GET /User - the endpoint checks whether the user's email already exists

Parameters

Parameter Type

Parameter

Data Type

Required?

Description

Header

X-MediaGroupCode

string

Y

Code that designates the circulation system.

Header

X-ClientCode

string

Y

Code that designates the client.

Header

X-PaperCode

string

Y

Code that designates the newspaper.

Header

X-SourceSystem

string

Y

Code that designates the application.

Header

Authorization

string

Y

Authorization token.

Header

X-RequestId

integer

Y

Defines where to look for the user. 1 = User Provider; 2 = Naviga's database; 0 User provider and Naviga's database (recommended)

Query string

request.email

string

Y

Email address that is checked.

Query string

request.onlyActive

boolean

Y

If TRUE, only checks active subscriptions. If FALSE, checks both active and inactive subscriptions.

Request

The following is a cURL request example:

Response

The following is a json example response from the /user endpoint:

Create user

POST /User - This endpoint creates the user if the user doesn't already exist.

Parameters

Parameter Type

Parameter

Data Type

Required?

Description

Header

X-MediaGroupCode

string

Y

Code that designates the circulation system.

Header

X-ClientCode

string

Y

Code that designates the client.

Header

X-PaperCode

string

Y

Code that designates the newspaper.

Header

X-SourceSystem

string

Y

Code that designates the application.

Header

Authorization

string

Y

Authorization token.

Header

X-RequestId

integer

Y

Defines where to look for the user. 1 = User Provider; 2 = Naviga's database; 0 User provider and Naviga's database (recommended)

Request body

integer

Y

JSON object (see request example below).

Request example

The following is a cURL request example:

Response example

The following is a json example response from the /User endpoint:

Address standardization

GET /Address/Standardization - this endpoint uses a service to standardize the entered address.

Parameters

Parameter Type

Parameter

Data Type

Required?

Description

Header

X-MediaGroupCode

string

Y

Code that designates the circulation system.

Header

X-ClientCode

string

Y

Code that designates the client.

Header

X-PaperCode

string

Y

Code that designates the newspaper.

Header

X-SourceSystem

string

Y

Code that designates the application.

Header

Authorization

string

Y

Authorization token.

Header

X-RequestId

integer

Y

Defines where to look for the user. 1 = User Provider; 2 = Naviga's database; 0 User provider and Naviga's database (recommended)

Query string

request.address.address

string

Y

Street address that is checked.

Query string

request.city

string

Y

City of address that is checked.

Query string

request.state

string

Y

State of address that is checked.

Query string

request.postalCode

number

Y

Postal code of address that is checked.

Request example

The following is a cURL request example:

Response example

The following is a json example response from the /Address/Standardization endpoint:

Active check

POST /Subscription/ActiveCheck - this endpoint checks the subscriber has an active subscription

Parameters

Parameter Type

Parameter

Data Type

Required?

Description

Header

X-MediaGroupCode

string

Y

Code that designates the circulation system.

Header

X-ClientCode

string

Y

Code that designates the client.

Header

X-PaperCode

string

Y

Code that designates the newspaper.

Header

X-SourceSystem

string

Y

Code that designates the application.

Header

Authorization

string

Y

Authorization token.

Header

X-RequestId

integer

Y

Defines where to look for the user. 1 = User Provider; 2 = Naviga's database; 0 User provider and Naviga's database (recommended)

Request body

integer

Y

JSON object (see request example below).

Request example

The following is a cURL request example:

Response example

The following is a json example response from the Subscriptions/ActiveCheck endpoint:

Start payment session

POST /Billing/PaymentSession/StartPaymentSession

Parameters

Parameter Type

Parameter

Data Type

Required?

Description

Header

X-MediaGroupCode

string

Y

Code that designates the circulation system.

Header

X-ClientCode

string

Y

Code that designates the client.

Header

X-PaperCode

string

Y

Code that designates the newspaper.

Header

X-SourceSystem

string

Y

Code that designates the application.

Header

Authorization

string

Y

Authorization token.

Header

X-RequestId

integer

Y

Defines where to look for the user. 1 = User Provider; 2 = Naviga's database; 0 User provider and Naviga's database (recommended)

Request body

integer

Y

JSON object (see request example below).

Request example

The following is a cURL request example:

Response example

The following is a json example response from the /Billing/PaymentSession/StartPaymentSession endpoint:

End payment session

POST /Billing/PaymentSession/EndPaymentSession

Parameters

Parameter Type

Parameter

Data Type

Required?

Description

Header

X-MediaGroupCode

string

Y

Code that designates the circulation system.

Header

X-ClientCode

string

Y

Code that designates the client.

Header

X-PaperCode

string

Y

Code that designates the newspaper.

Header

X-SourceSystem

string

Y

Code that designates the application.

Header

Authorization

string

Y

Authorization token.

Header

X-RequestId

integer

Y

Defines where to look for the user. 1 = User Provider; 2 = Naviga's database; 0 User provider and Naviga's database (recommended)

Request body

integer

Y

JSON object (see request example below).

Request example

The following is a cURL request example:

Response example

The following is a json example response from the /Billing/PaymentSession/EndPaymentSession endpoint:

Create subscription

POST /Subscriptions - this endpoint creates the subscription after the user selects to submit the order

Parameters

Parameter Type

Parameter

Data Type

Required?

Description

Header

X-MediaGroupCode

string

Y

Code that designates the circulation system.

Header

X-ClientCode

string

Y

Code that designates the client.

Header

X-PaperCode

string

Y

Code that designates the newspaper.

Header

X-SourceSystem

string

Y

Code that designates the application.

Header

Authorization

string

Y

Authorization token.

Header

X-RequestId

integer

Y

Defines where to look for the user. 1 = User Provider; 2 = Naviga's database; 0 User provider and Naviga's database (recommended)

Request body

integer

Y

JSON object (see request example below).

Request example

The following is a cURL request example:

Response example

The following is a json example response from the /Subscriptions endpoint:

PreviousNewstart InApp (Webhooks)NextEntitlements API Reference

Last updated

Was this helpful?