List specific products - client mode

Production

https://api.mediaconnect.no/capi

GET

/v1/client/product/{productType}

Only the client needs to be logged in to use this endpoint. The user does not need to be logged in, click here to read more.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.mediaconnect.no/capi/v1/client/product/?productId&shop'

Response Example

200 - Success

{
    "products": [
        {
            "companyCode": "468979834",
            "product": "CO27409",
            "description": "This is a product",
            "productType": "magazine",
            "startTime": 1560336440000,
            "endTime": 1591958840000,
            "weight": 99.9,
            "campaigns": "New",
            "currency": "NOK",
            "webOfferPrice": 89.9,
            "retailPrice": 67.75,
            "vatPercent": 0,
            "digital": false
        }
    ]
}

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://connectid.no/user/oauth/token

Refresh URL: https://connectid.no/user/oauth/token

Scopes:

read-For all access

Path Params

productType

string

required

Possible value: subscription.

<= 12 characters

Query Params

productId

string

optional

Only return info about one product

<= 12 characters

shop

boolean

optional

Informs if a product is available for web shop.

true: The product is available for web shop.

false: The product is unavailable for web shop.

Default:

false

Responses

🟢200OK

application/json

Body

products

array [object {15}]

optional

companyCode

string

optional

Company code for the product

<= 12 characters

product

string

optional

Product code

<= 12 characters

description

string

optional

Description of the product

<= 40 characters

productType

enum<string>

optional

Vaild product type:

magazine

newspaper:

series: A set of periodicals, books or other documents published under a common title.

general

Allowed values:

magazinenewspaperseriesgeneral

startTime

integer

optional

Start time to use this product.

Unix Epoch timestamps in milliseconds since 1st January 1970 UTC.

endTime

integer

optional

End time to use this product

Unix Epoch timestamps in milliseconds since 1st January 1970 UTC.

weight

number

optional

Weight in grams.

Multiple of:

0.01

campaigns

string

optional

campaign

currency

string

optional

Currency code for product price ISO4217 - alphabetic code. Only used when productType is general.

<= 3 characters

webOfferPrice

number

optional

Web offer price, typically discounted price compared to retail price. Only used when productType general

Multiple of:

0.01

retailPrice

number

optional

Retail or list price. Only used when productType is general.

Multiple of:

0.01

vatPercent

number

optional

VAT percent to use for this product. Vat included or excluded in given prices.

Multiple of:

0.01

digital

boolean

optional

Informs if it is a digital product.

true: It is a digital product

false: It is not a digital product

group1

string

optional

Free text field.

<= 12 characters

orderTypeCodes

array[string]

optional

Order type codes which a general product is allowed for use on

🟠400Bad Request

🟠429Too Many Requests

🔴500Server Error

Modified at 2025-05-08 08:03:51

Check product - client mode

List productdeliveryplan - client mode