Criar uma categoria

Criar uma categoria faz-se enviando um pedido POST para o endpoint /categories.

title é obrigatório (máx. 100). slug é gerado a partir de title quando o omites. description é opcional (máx. 2000). parent é um id de categoria.

Criar objeto de categoria

CURL


curl -X POST https://app.ignitevideo.cloud/api/categories \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"title": "Your category title", "slug":"your-category-slug"}'

JavaScript / Node.js


const data = {
  "title": "Your category title",
  "slug": "your-category-slug"
}
const response = await fetch(`https://app.ignitevideo.cloud/api/categories`, {
method: 'POST',
body: JSON.stringify(data),
headers: {
  'Authorization': `Bearer YOUR_TOKEN`,
  'Content-Type': 'application/json'
}
});

PHP


$client = new GuzzleHttp\Client();
$data = [
  "title" => "Your category title",
  "slug" => "your-category-slug"
];
$response = $client->request('POST', 'https://app.ignitevideo.cloud/api/categories', [
'body' => json_encode($data),
'headers' => [
  'Authorization' => 'Bearer YOUR_TOKEN',
  'Content-Type' => 'application/json'
]
]);

Resposta

O estado da resposta é 201. O corpo é o novo objeto de categoria dentro de doc, mais uma mensagem.


{
  "doc": {
    "id": "[CATEGORY_ID]",
    "title": "Your category title",
    "slug": "your-category-slug"
  },
  "message": "Category successfully created."
}