masstack

V1
API Overview Resources Schemas

Provision TV HBO

HBO (Warner Bros. Discovery. WBD) provides users access to WBD content across various application and platform combinations including mobile devices, smart TVs, and desktop computers. A direct integration provides opportunities for partners to enhance their digital experiences for their existing users or to make digital offerings available for new users.

Parameters

Name In Type Required Description
org_id path string true Tenant
Request-Correlation-Id header string true A reference for this transaction that can be used to track it.
body body HboCreateSubscription true ‘none’

Request body - JsonObject

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
  "service_id": 1234567890123456,
  "external_id": 1234567890123456,
  "country": "ES",
  "product_code": "HBO",
  "product_name": "HBO",
  "product_start_date": "2021-01-01T00:00:00Z",
  "product_expire_date": "2021-01-01T00:00:00Z",
  "product_renew_date": "2021-01-01T00:00:00Z"
}
Name Type Required Description
service_id HboServiceId true Service identifier in HBO. Corresponds to Subscription Id.
external_id HboExternalId true Partner user identifier in HBO. It’s the Id in CRM.
country HboCountry true Country code. ISO 3166-1 alpha-2 code.
product_code HboProductCode true Product code
product_name HboProductName false Product name
product_start_date HboProductStartDate true Product start date
product_expire_date HboProductExpireDate false Product expire date
product_renew_date HboProductRenewDate false Product renew date

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


curl -X POST https://provision-master.private.dev.k8s.masmovil.com/v1/tv/hbo/orgs/masmovil/subscriptions \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Request-Correlation-Id: Workflow Id (unique identifier)" \
 --data-raw "{
  'service_id': 1234567890123456,
  'external_id': 1234567890123456,
  'country': 'ES',
  'product_code': 'HBO',
  'product_name': 'HBO',
  'product_start_date': '2021-01-01T00:00:00Z',
  'product_expire_date': '2021-01-01T00:00:00Z',
  'product_renew_date': '2021-01-01T00:00:00Z'
}"

Responses

Code Meaning Description Schema
202 Accepted The operation request was successfully accepted, returned the request external reference identifier. WorkflowResponse
400 Bad Request Bad Request [Error]
401 Unauthorized Unauthorized request [Error]
500 Internal Server Error Internal Server Error [Error]

Parameters

Name In Type Required Description
org_id path string true Tenant
subscription_id path string true Subscription identifier. Corresponds to the Service Id in HBO.
Request-Correlation-Id header string true A reference for this transaction that can be used to track it.
body body HboCancelSubscription true ‘none’

Request body - JsonObject

1
2
3
4
5
6

{
  "external_id": 1234567890123456,
  "reason": "PRODUCT_CANCELED",
  "product_code": "HBO",
  "product_expire_date": "2021-01-01T00:00:00Z"
}
Name Type Required Description
external_id HboExternalId true Partner user identifier in HBO. It’s the Id in CRM.
reason HboReason true Reason for the cancellation
product_code HboProductCode true Product code
product_expire_date HboProductExpireDate false Product expire date

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


curl -X PUT https://provision-master.private.dev.k8s.masmovil.com/v1/tv/hbo/orgs/masmovil/subscriptions/4567890123456789/cancel \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Request-Correlation-Id: Workflow Id (unique identifier)" \
 --data-raw "{
  'external_id': 1234567890123456,
  'reason': 'PRODUCT_CANCELED',
  'product_code': 'HBO',
  'product_expire_date': '2021-01-01T00:00:00Z'
}"

Responses

Code Meaning Description Schema
202 Accepted The cancel operation request was successfully accepted, returned the request external reference identifier. WorkflowResponse
400 Bad Request Bad Request [Error]
401 Unauthorized Unauthorized request [Error]
500 Internal Server Error Internal Server Error [Error]

Parameters

Name In Type Required Description
org_id path string true Tenant
subscription_id path string true Subscription identifier. Corresponds to the Service Id in HBO.
body body HboGenerateActivationUrl true ‘none’

Request body - JsonObject

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
  "external_id": 1234567890123456,
  "country": "ES",
  "product_code": "HBO",
  "product_name": "HBO",
  "product_start_date": "2021-01-01T00:00:00Z",
  "product_expire_date": "2021-01-01T00:00:00Z",
  "product_renew_date": "2021-01-01T00:00:00Z",
  "transaction_id": 4567890123456789
}
Name Type Required Description
external_id HboExternalId true Partner user identifier in HBO. It’s the Id in CRM.
country HboCountry false Country code. ISO 3166-1 alpha-2 code.
product_code HboProductCode true Product code
product_name HboProductName false Product name
product_start_date HboProductStartDate true Product start date
product_expire_date HboProductExpireDate false Product expire date
product_renew_date HboProductRenewDate false Product renew date
transaction_id HboTransactionId false ID of the transaction that granted the user access to the product.

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


curl -X POST https://provision-master.private.dev.k8s.masmovil.com/v1/tv/hbo/orgs/masmovil/subscriptions/4567890123456789/activation-url \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'external_id': 1234567890123456,
  'country': 'ES',
  'product_code': 'HBO',
  'product_name': 'HBO',
  'product_start_date': '2021-01-01T00:00:00Z',
  'product_expire_date': '2021-01-01T00:00:00Z',
  'product_renew_date': '2021-01-01T00:00:00Z',
  'transaction_id': 4567890123456789
}"

Responses

Code Meaning Description Schema
200 OK Activation URL successfully generated. HboGenerateActivationURLResponse
400 Bad Request Bad Request [Error]
401 Unauthorized Unauthorized request [Error]
500 Internal Server Error Internal Server Error [Error]

Endpoints

Provision TV Amazon

    Provision TV Netflix

      Provision TV HBO

        Provision FTTH

          Provision Orange TV

            Tesamanager

              Device Insurance