Categories

Get Categories by PID

Trae todas las categorías (todos los niveles, sin drill-down) de un publisher.

GET/api/v4/categories

Required Params

Param	Tipo
`access_token`	string, required
`pid`	int, required

Response example

[
  { "id": 1, "name": "Categoria 1", "level": 0, "parent": 0 },
  { "id": 2, "name": "Deportes", "level": 1, "parent": 1 }
]

Igual a v3 — level es una columna guardada (se fija al crear la categoría a partir del level del padre + 1), no se recalcula caminando el árbol en cada consulta. parent: 0 significa raíz. Una misma categoría puede estar relacionada a más de un publisher (no es dueña de un solo pid).

Get Content in a category id (cid)

Contenido asignado a una categoría puntual.

GET/api/v4/category/categoryId/:cid/contents

Required Params

Param	Tipo
`access_token`	string, required
`from`	int, opcional
`limit`	int, opcional, máximo 100, default 50

Response example

[
  {
    "name": "noa video.mp4",
    "description": null,
    "content_id": 100006089,
    "thumb": "",
    "categories": "1303",
    "tags": [],
    "status": "enabled",
    "gid": 1,
    "group_name": "Artear",
    "publisher_id": 2,
    "publisher_name": "Eltrece",
    "created_at": "2019-07-03 17:23:55",
    "created_by": "Jonathan Lowenstern",
    "content_type": "video",
    "external_id": "2-1303-JJRyeR1562185434734",
    "plays": 0,
    "impressions": 0
  }
]

Igual a v3, incluida la rareza de categories como string (el id de la categoría consultada) en vez de array.

Create new category

Crea una categoría nueva, opcionalmente anidada bajo otra.

POST/api/v4/category

Body (JSON)

Param	Tipo
`access_token`	string, required
`pid`	int, required
`name`	string, required
`level`	int, required en v3
`parent`	int, opcional

Response example

{
  "info": "Category created OK!",
  "cid": 1373
}

Diferencias vs v3: level se acepta pero se ignora — acá se recalcula solo a partir de parent, así que nunca puede quedar inconsistente con el árbol real.