title: POST /api/products/:id description: Vytvoření nebo akce nad produktem se známým ID.

POST /api/products/:id

URL: /api/products/68b5b692be9080affaa098c3
Metoda: POST
Autorizace: dle projektu
Content-Type: application/json

Tento endpoint použijte k vytvoření produktu s předem daným ID nebo ke spuštění vlastní akce nad produktem. Pokud vaše instalace podporuje standardní vytváření, zvažte také POST /api/products bez ID.

Tělo požadavku

Přijímá objekt Product. Minimálně užitečná pole:

basic.product_name — string (povinné)
basic.product_desc — string
basic.location — string
additional.price — number
additional.caution — number
additional.time_unit — string, např. day
additional.selectedTerm — ID podmínek, které se mají aplikovat. Musí odpovídat některému z basic.rent_owner.terms.termsArray[].id.
settings.published — boolean
settings.slug — string
gallery.images[] — volitelné objekty obrázků

Příklad:


 
{
	"internal_name": "Example Product",
	"basic": {
		"product_name": "Example Product",
		"product_desc": "Example description ...",
		"location": "Example City"
	},
	"additional": {
		"price": 500,
		"caution": 1000,
		"time_unit": "day",
		"selectedTerm": "qjnagbx6h1j"
	},
	"settings": {
		"published": true,
		"slug": "vycepni-zarizeni-pipa-lindr-as-40-2-kohout-zwxfkxo"
	}
}

Poznámka: V uvedeném příkladu additional.selectedTerm odkazuje na položku v basic.rent_owner.terms.termsArray.

Úspěšná odpověď

Stav: 201 Created (nebo 200 OK při provedení akce)
Tělo: vytvořený/ovlivněný objekt Product


{
	"id": "68b5b692be9080affaa098c3",
	"createdAt": "2025-09-01T15:06:58.847Z",
	"updatedAt": "2025-09-01T15:07:09.125Z",
	"internal_name": "Example Product",
	"basic": {
		"product_name": "Example Product",
		"product_desc": "Example description ...",
		"location": "Example City"
	},
	"additional": {
		"price": 500,
		"caution": 1000,
		"time_unit": "day",
		"selectedTerm": "qjnagbx6h1j"
	},
	"settings": {
		"published": true,
		"slug": "vycepni-zarizeni-pipa-lindr-as-40-2-kohout-zwxfkxo"
	}
}

Chyby

400 Bad Request při validační chybě
401/403 při neautorizovaném/zakázaném přístupu
409 Conflict pokud ID již existuje a upsert není povolen

Ukázka chybové odpovědi:


{
	"errors": [
		{
			"message": "Validation failed: basic.product_name is required",
			"field": "basic.product_name"
		}
	]
}

Poznámky

Pokud vaše konfigurace Rentall používá hooky nebo přístupová pravidla, výsledné tvary odpovědí a status kódy se mohou lišit. Pro přesné chování vždy vycházejte z konfigurace vašeho projektu.

Příklady

curl


curl -s -X POST \
	-H "Authorization: Bearer $RENTALL_TOKEN" \
	-H "Content-Type: application/json" \
	-d '{
		"internal_name":"Example Product",
		"basic":{"product_name":"Example Product","location":"Example City"},
		"additional":{"price":500,"caution":1000,"time_unit":"day","selectedTerm":"qjnagbx6h1j"},
		"settings":{"published":true,"slug":"example-product"}
	}' \
	https://rentall.cz/api/products/68b5b692be9080affaa098c3

JavaScript


const token = process.env.RENTALL_TOKEN;
const body = {
	internal_name: "Example Product",
	basic: { product_name: "Example Product", location: "Example City" },
	additional: { price: 500, caution: 1000, time_unit: "day", selectedTerm: "qjnagbx6h1j" },
	settings: { published: true, slug: "example-product" }
};
const res = await fetch("https://rentall.cz/api/products/68b5b692be9080affaa098c3", {
	method: "POST",
	headers: {
		Authorization: `Bearer ${token}`,
		"Content-Type": "application/json"
	},
	body: JSON.stringify(body)
});
const data = await res.json();
console.log(data.id);

TypeScript


interface Product { id: string }
const token = process.env.RENTALL_TOKEN as string;
const res = await fetch("https://rentall.cz/api/products/68b5b692be9080affaa098c3", {
	method: "POST",
	headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
	body: JSON.stringify({ basic: { product_name: "Example Product", location: "Example City" } })
});
const created: Product = await res.json();
console.log(created.id);

PHP


<?php
$token = getenv('RENTALL_TOKEN');
$payload = json_encode([
	'internal_name' => 'Example Product',
	'basic' => ['product_name' => 'Example Product', 'location' => 'Example City']
]);
$ch = curl_init('https://rentall.cz/api/products/68b5b692be9080affaa098c3');
curl_setopt_array($ch, [
	CURLOPT_RETURNTRANSFER => true,
	CURLOPT_POST => true,
	CURLOPT_HTTPHEADER => [
		'Authorization: Bearer ' . $token,
		'Content-Type: application/json'
	],
	CURLOPT_POSTFIELDS => $payload
]);
$resp = curl_exec($ch);
if ($resp === false) throw new Exception(curl_error($ch));
curl_close($ch);
$data = json_decode($resp, true);
echo $data['id'] ?? '';