Get started

The API provides programmatic access to read/set/delete data from DTVSol middleware.

To use this API, you need an API key. You can obtain it from your DTVSol middleware, under section Settings

Token:

Aways you must send the token into your http header request:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/channels/" -H "accept: application/json" -H "Token: "

CHANNELS

get channels

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/channels/{channelId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

PPV

get channels

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/channels/{channelId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

CHANNEL PACKS

get channel pack infoNEW

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/packs/{pack_id}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RETURN PARAMETERS

add channel pack NEW

Base url:
/usr/bin/curl -ss -X POST "http://api.dtvsol.info/packs/" -H "accept: application/json" -H "Token: " -d "{\"name\":\"\",\"code\":\"\",\"hd\":\"\", \"broadcaster_id\":\"\"}"

QUERY PARAMETERS

RETURN PARAMETERS

edit channel pack NEW

Base url:
/usr/bin/curl -ss -X PATCH "http://api.dtvsol.info/packs/{pack_id}" -H "accept: application/json" -H "Token: " -d "{\"name\":\"\",\"code\":\"\",\"hd\":\"\", \"broadcaster_id\":\"\"}"

QUERY PARAMETERS

RETURN PARAMETERS

delete channel pack NEW

Base url:
/usr/bin/curl -ss -X DELETE "http://api.dtvsol.info/packs/{pack_id}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RETURN PARAMETERS

CLIENTS

get client info

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/clients/{clientId}?limit=10&offset=0" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

add client

Base url:
/usr/bin/curl -ss -X POST "http://api.dtvsol.info/clients/" -H "accept: application/json" -H "Token: " -d "{\"name\":\"\",\"nie\":\"\",\"address\":\"\",\"phone\":\"\",\"email\":\"\",\"vip\":\"\",\"vod\":\"\",\"limit\":\"\",\"timeshift\":\"\",\"note\":\"\",\"data\":{\"proxyServerId\":\"\",\"tariffId\":\"\", \"endDate\":\"\"}}"

QUERY PARAMETERS

edit client

Base url:
/usr/bin/curl -ss -X PATCH "http://api.dtvsol.info/clients/{clientId}/" -H "accept: application/json" -H "Token: " -d "{\"name\":\"\",\"nie\":\"\",\"address\":\"\",\"phone\":\"\",\"email\":\"\",\"vip\":\"\",\"vod\":\"\",\"limit\":\"\",\"timeshift\":\"\",\"note\":\"\",\"data\":{\"proxyServerId\":\"\",\"tariffId\":\"\"}, \"endDate\":\"\"}"

QUERY PARAMETERS

RETURN PARAMETERS

run client

Base url:
/usr/bin/curl -ss -X PATCH "http://api.dtvsol.info/clients/{clientId}/?action=runClient" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RETURN PARAMETERS

suspend client

Base url:
/usr/bin/curl -ss -X PATCH "http://api.dtvsol.info/clients/{clientId}/?action=suspendClient" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RETURN PARAMETERS

delete client

Base url:
/usr/bin/curl -ss -X DELETE "http://api.dtvsol.info/clients/{clientId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RETURN PARAMETERS

DEVICES

get device info

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/devices/{device_id}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

add device

Base url:
/usr/bin/curl -ss -X POST "http://api.dtvsol.info/devices/{clientId}" -H "accept: application/json" -H "Token: " -d "{\"type\":\"\",\"proxyId\":\"\",\"tariffId\":\"\",\"note\":\"\"}"

QUERY PARAMETERS

RETURN PARAMETERS

edit device

Base url:
/usr/bin/curl -ss -X PATCH "http://api.dtvsol.info/devices/{deviceId}/" -H "accept: application/json" -H "Token: " -d "{\"code\":\"\",\"mac\":\"\",\"type\":\"\",\"proxyId\":\"\",\"tariffId\":\"\",\"note\":\"\"}"

QUERY PARAMETERS

RETURN PARAMETERS

delete device

Base url:
/usr/bin/curl -ss -X DELETE "http://api.dtvsol.info/devices/{deviceId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RETURN PARAMETERS

DEMO CODES NEW

Trial / promo codes for "free days" campaigns. A demo code is a dormant anonymous client plus one web-only device whose 9-digit code (<proxy><random>) is printed on a card. Codes are generated on the company's web-portal proxy, which is resolved automatically.

When does the trial clock start? The clock (days_remaining) NEVER starts at generation. You have two options, pick one — you do not need both:

• Do nothing (recommended): just create the code and hand it out. The trial starts automatically the first time the customer opens the portal and watches — our system activates it on first use. This way the customer never loses unused days.
• Activate yourself: call activate (below) to start the clock on demand, e.g. the moment your app gives the code to a customer.

Whichever happens first wins, and it is permanent — activation is idempotent, so a code already started (by either path) is never reset or extended.

generate demo codes NEW

Base url:
/usr/bin/curl -ss -X POST "http://api.dtvsol.info/demoCodes/" -H "accept: application/json" -H "Token: " -d "{\"quantity\":500,\"demoDays\":5,\"tariffId\":\"\",\"batch\":\"risaralda-jun\"}"

QUERY PARAMETERS

RESPONSE

{"batch":"risaralda-jun","proxyId":208,"portalUrl":"https://risaralda.pruebatv.red/portal","demoDays":5,"count":500,"codes":["208431422","208752883", ...],"result":"ok"}

Open the portal for a code at portalUrl (e.g. portalUrl?code=208431422).

get demo code status NEW

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/demoCodes/{code}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RESPONSE

{"demoCode":{"code":"208431422","name":"Juan Perez","batch":"risaralda-jun","state":"active","claimed_at":"2026-06-07 14:10:00","end_date":"2026-06-12","demo_days":5,"days_remaining":4,"portalUrl":"https://risaralda.pruebatv.red/portal"},"result":"ok"}

state is one of generated (never used), active (trial running) or expired.

update demo code NEW

Base url:
/usr/bin/curl -ss -X PATCH "http://api.dtvsol.info/demoCodes/{code}" -H "accept: application/json" -H "Token: " -d "{\"name\":\"\",\"phone\":\"\",\"note\":\"\"}"

QUERY PARAMETERS

Only descriptive fields are updated. The trial clock (end_date) is never changed by this call — use activate below to start it, or it starts automatically on first watch.

activate demo code NEW

Start the trial clock for a code now (instead of waiting for first watch). Useful when your app hands a code to a customer and you want the days to begin immediately. Base url:
/usr/bin/curl -ss -X POST "http://api.dtvsol.info/demoCodes/{code}/activate" -H "accept: application/json" -H "Token: " -d "{\"days\":5}"

QUERY PARAMETERS

RESPONSE

{"demoCode":{"code":"208134230","state":"active","claimed_at":"2026-06-08 14:23:17","end_date":"2026-06-13","demo_days":5,"days_remaining":5,"already":false,...},"result":"ok"}

Activation is idempotent and first-one-wins: calling it on an already-active code returns the existing trial unchanged with already:true — it never resets or extends a running trial. The new end_date is pushed to the proxy so the trial is enforced immediately.

BROADCASTERS

get channels

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/channels/{channelId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RADIO

get channels

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/channels/{channelId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RESTREAMERS

get channels

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/channels/{channelId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

PROXIES

get channels

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/channels/{channelId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

TRANSCODERS

get channels

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/channels/{channelId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

CONTROL

send fingerprint NEW

Send fingerprint to devices. Fingerprints are visual watermarks displayed on video streams to identify devices/clients/channels.

Endpoint Variants:

• /fingerprint/device/{deviceId} - Send to a specific device
• /fingerprint/client/{clientId} - Send to all devices of a client
• /fingerprint/reseller/{resellerId} - Send to all devices of reseller's clients
• /fingerprint/channel/{channelId} - Send to all devices (for specific channel)
• /fingerprint/broadcaster/{broadcasterId} - Send to all devices (for broadcaster's channels)
• /fingerprint/pack/{packId} - Send to all devices (for channel pack)
• /fingerprint/tariff/{tariffId} - Send to all devices with specific tariff

Example (device):
/usr/bin/curl -ss -X POST "http://api.dtvsol.info/fingerprint/device/12345" -H "accept: application/json" -H "Token: " -d "{\"fingerprintType\":\"text\",\"fingerprintInformation\":\"deviceId\",\"fingerprintDuration\":15,\"fingerprintTTL\":24,\"fingerprintPosition\":[\"topLeft\",\"bottomRight\"],\"fingerprintFontSize\":18,\"fingerprintFontColor\":5,\"fingerprintBackgroundColor\":0}"

Example (dots):
/usr/bin/curl -ss -X POST "http://api.dtvsol.info/fingerprint/device/12345" -H "accept: application/json" -H "Token: " -d "{\"fingerprintType\":\"dots\",\"fingerprintInformation\":\"deviceId\",\"fingerprintDuration\":30,\"fingerprintTTL\":48}"

URL PARAMETERS

BODY PARAMETERS (JSON)

RETURN PARAMETERS

COLOR REFERENCE

EXAMPLES

Text fingerprint with device ID to a specific device:

{
  "fingerprintType": "text",
  "fingerprintInformation": "deviceId",
  "fingerprintDuration": 15,
  "fingerprintTTL": 24,
  "fingerprintPosition": ["topLeft", "bottomRight"],
  "fingerprintFontSize": 18,
  "fingerprintFontColor": 5,
  "fingerprintBackgroundColor": 0
}

Dots fingerprint to all client devices:

{
  "fingerprintType": "dots",
  "fingerprintInformation": "deviceId",
  "fingerprintDuration": 30,
  "fingerprintTTL": 48
}

Success Response:

{
  "result": "ok",
  "message": "Fingerprint sent to device",
  "success": true,
  "errorText": null
}

Error Response:

{
  "result": "error",
  "errorText": "Invalid fingerprintType. Must be: text or dots"
}

get data

search UPDATED

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/search?entity=channels&field=name&query=HBO&limit=10" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

get channels

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/channels/{channelId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

get radios

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/radios/{radioId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

get packs

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/packs/{packId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

get tariffs

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/tariffs/{tariffId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

get devices

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/devices/{device_id}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

get clients

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/clients/{clientId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

get proxies

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/proxies/{proxyId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

get restreamers

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/restreamers/{restreamerId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

get transcoders

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/transcoders/{transcoderId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

get server zones

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/serverZones/{zoneId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

get channels groups

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/channelGroups/{groupId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

get device code

Base url:
/usr/bin/curl -ss -X GET "http://api.dtvsol.info/deviceCode/{clientId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RETURN PARAMETERS

set data

add client

Base url:
/usr/bin/curl -ss -X POST "http://api.dtvsol.info/clients/" -H "accept: application/json" -H "Token: " -d "{\"name\":\"\",\"nie\":\"\",\"address\":\"\",\"phone\":\"\",\"email\":\"\",\"vip\":\"\",\"vod\":\"\",\"limit\":\"\",\"timeshift\":\"\",\"note\":\"\",\"data\":{\"proxyServerId\":\"\",\"tariffId\":\"\"}}"

QUERY PARAMETERS

add device

Base url:
/usr/bin/curl -ss -X POST "http://api.dtvsol.info/devices/{clientId}" -H "accept: application/json" -H "Token: " -d "{\"code\":\"\",\"mac\":\"\",\"type\":\"\",\"proxyId\":\"\",\"tariffId\":\"\",\"note\":\"\"}"

QUERY PARAMETERS

RETURN PARAMETERS

change data

set PPV channel to paid (allow view - subscribe)

Base url:
/usr/bin/curl -ss -X PATCH "http://api.dtvsol.info/subscribeToChannel/{clientId}/{endDate}/{deviceId}/{channelId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RETURN PARAMETERS

set PPV/GROUP pack to paid (allow view - subscribe) - UPDATED

Base url:
/usr/bin/curl -ss -X PATCH "http://api.dtvsol.info/subscribeToPack/{clientId}/{endDate}/{deviceId}/{packId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RETURN PARAMETERS

change data client

Base url:
/usr/bin/curl -ss -X PATCH "http://api.dtvsol.info/clients/{clientId}/" -H "accept: application/json" -H "Token: " -d "{\"name\":\"\",\"nie\":\"\",\"address\":\"\",\"phone\":\"\",\"email\":\"\",\"vip\":\"\",\"endDate\":\"\",\"vod\":\"\",\"limit\":\"\",\"timeshift\":\"\",\"note\":\"\",\"data\":{\"proxyServerId\":\"\",\"tariffId\":\"\"}}"

QUERY PARAMETERS

RETURN PARAMETERS

run Client

Base url:
/usr/bin/curl -ss -X PATCH "http://api.dtvsol.info/runClient/{clientId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RETURN PARAMETERS

suspend Client

Base url:
/usr/bin/curl -ss -X PATCH "http://api.dtvsol.info/suspendClient/{clientId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RETURN PARAMETERS

delete data

unsubscribe PPV channel

Base url:
/usr/bin/curl -ss -X PATCH "http://api.dtvsol.info/unSubscribeToChannel/{clientId}/{channelId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RETURN PARAMETERS

unsubscribe PPV pack

Base url:
/usr/bin/curl -ss -X PATCH "http://api.dtvsol.info/unSubscribeToPack/{clientId}/{channelId}" -H "accept: application/json" -H "Token: "

QUERY PARAMETERS

RETURN PARAMETERS

Errors

The Westeros API uses the following error codes: