Suggest channels for a new stream

POST/streams/providers/links/suggest/

write Change: creates or edits. Scopes

The channels a stream not saved yet most likely is, from its name and source addresses (main first): the channel its sources play, then channels of the same or a similar name. Panel operators only.

Body

namestring
sourcesstring[]

Response

200 OK

suggestionsobject[]required
- providerintegerrequired
- provider_namestringrequired
- item_idstringrequired
  The channel's id at the provider.
- item_namestringrequired
- whystringrequired
  source: one of the stream's sources plays it; name: same name; similar: a name that contains it.
  - source - source
  - name - name
  - similar - similar
- source_orderintegerrequiredcan be null
  Which source plays it (0: the main one).
- ambiguousbooleanrequired
  The sources play more than one channel: pick one.

Errors

400 Something sent is not valid. Each field that is wrong is named with what is wrong.
401 No credential, or one that is wrong, expired or revoked.
403 The account, or the key's or app's scopes, may not do this.
429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means

cURL

curl -X POST 'https://panel.example.com/streams/providers/links/suggest/' \
  -H "Authorization: Bearer $MINIMUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "",
  "sources": [
    "string"
  ]
}'

Python

import os
import requests

response = requests.post(
    "https://panel.example.com/streams/providers/links/suggest/",
    headers={"Authorization": f"Bearer {os.environ['MINIMUS_API_KEY']}"},
    json={
        "name": "",
        "sources": [
            "string"
        ]
    },
)
response.raise_for_status()
print(response.json())

JavaScript

const response = await fetch('https://panel.example.com/streams/providers/links/suggest/', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.MINIMUS_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "name": "",
    "sources": [
      "string"
    ]
  }),
});
if (!response.ok) throw new Error(`${response.status}`);
console.log(await response.json());

Response 200

{
  "suggestions": [
    {
      "provider": 1,
      "provider_name": "string",
      "item_id": "string",
      "item_name": "string",
      "why": {
        "0": "s",
        "1": "o",
        "2": "u",
        "3": "r",
        "4": "c",
        "5": "e"
      },
      "source_order": 1,
      "ambiguous": true
    }
  ]
}

Suggest channels for a new stream

Body#

Response#

200 OK

Errors#

Body

Response

Errors