Mídias

Esta API permite a gestão de mídias, oferecendo opções para listar, adicionar e editar os dados cadastrados.

Endpoints

• Lista de mídias

URL: <seuprojeto>.edgecontents.com/ds/api/media

Método: GET

Autenticação: Basic Auth

Parâmetros de Consulta:

Parâmetro	Tipo	Descrição
id	int	ID do cliente
domain	text	Domínio do cliente
cnpj	text	CNPJ do cliente
campaign	int	ID da campanha

Obs: ao menos um dos parâmetros é necessário para consulta.

Exemplo de retorno:

{
    "1": {
        "name": "climatempo_responsivo_10s_16x9",
        "screen_format_id": 2,
        "screen_format": "672x336",
        "duration": "00:00:10",
        "campaign_id": 10
    },
    "6": {
        "name": "climatempo_responsivo_10s_v2",
        "screen_format_id": 5,
        "screen_format": "1080x360",
        "duration": "00:00:10",
        "campaign_id": null
    }
}

• Cadastro de mídia

URL: <seuprojeto>.edgecontents.com/ds/api/media/add

Método: POST

Autenticação: Basic Auth

Corpo da Requisição (form-data):

Campo	Tipo	Obrigatório	Descrição
title	Text	Sim	Nome da mídia
customer	Text	Sim	ID do cliente
campaign	Text	Sim	ID da campanha
screenformat	Text	Sim	Formato de tela
duration	Text	Não	Duração
file	File	-	Caminho do arquivo
file_url	Text	-	URL da mídia

Exemplo de requisição com file:

curl --location '<seuprojeto>.edgecontents.com/ds/api/media/add' \
--header 'Authorization: ••••••' \
--header 'Cookie: PHPSESSID=57a6umud56v0e4a' \
--form 'file=@"/C:/Users/lalca/Desktop/arquivo.png"' \
--form 'customer="1"' \
--form 'campaign="30"' \
--form 'title="Mídia Exemplo"' \
--form 'screenformat="12"'

Exemplo de requisição com file_url:

curl --location '<seuprojeto>.edgecontents.com/ds/api/media/add' \
--header 'Authorization: ••••••' \
--header 'Cookie: PHPSESSID=57a6umud56v0e4a' \
--form 'file_url="https://images.com/img/2022/11/18/10-segundos-horizontal.mp4"' \
--form 'customer="1"' \
--form 'campaign="30"' \
--form 'title="Mídia Exemplo"' \
--form 'screenformat="12"'

Exemplo de retorno:

{
    "successes": [
        {
            "id": "319",
            "name": "Mídia Exemplo"
        }
    ],
    "errors": []
}

• Edição de mídia

URL: <seuprojeto>.edgecontents.com/ds/api/media/update

Método: POST

Autenticação: Basic Auth

Corpo da Requisição (form-data):

Campo	Tipo	Obrigatório	Descrição
id	Text	Sim	ID da mídia
title	Text	Não	Nome da mídia
screenformat	Text	Não	Formato de tela
duration	Text	Não	Duração
file	File	Não	Caminho do arquivo

Exemplo de requisição:

curl --location '<seuprojeto>.edgecontents.com/ds/api/media/update' \
--header 'Authorization: ••••••' \
--header 'Cookie: PHPSESSID=57a6umud56v0e4a' \
--form 'id="319"' \
--form 'title="Mídia Exemplo Atualização"'

Exemplo de retorno:

{
    "successes": [
        {
            "id": "319",
            "name": "Mídia Exemplo Atualização"
        }
    ],
    "errors": []
}

• Lista de publicação

URL: <seuprojeto>.edgecontents.com/ds/api/media/publication

Método: GET

Autenticação: Basic Auth

Parâmetros de Consulta:

Campo	Tipo	Obrigatório	Descrição
id	Text	Sim	ID da mídia

Exemplo de retorno:

{
    "name": "43498-unilever-brasil-maizena-2160x3840_n68n6j_default",
    "screen_format_id": 12,
    "customer_id": 28,
    "campaign_id": 31,
    "playlistitems": [
        {
            "playlist_id": 267,
            "playlist_name": "Comercial - 5",
            "start": "2026-01-26 09:55:49",
            "end": null,
            "allscreens": 0,
            "screens": [
                {
                    "id": 14,
                    "name": "PC UBUNTU 24.04"
                },
                {
                    "id": 6,
                    "name": "TV Entrada"
                },
            ],
            "sites": [],
            "groups": []
        }
    ]
}