title: POST /api/rents description: Vytvoření dokumentu pronajímatele (profil/společnost).

POST /api/rents

URL: /api/rents
Metoda: POST
Autorizace: dle projektu
Content-Type: application/json

Vytvoří nového pronajímatele v Rentall API.

Tělo požadavku

Minimálně užitečná pole:

basic.rentalName — string (povinné)
basic.rentalContactPerson — string
basic.rentalPhone — string
basic.rentalEmail — string (použijte oficiální kontakt nebo vlastní)
basic.rentalIco — string
basic.rentalStyle — např. commission nebo click

Příklad:


{
  "basic": {
    "rentalName": "Example Rentals s.r.o.",
    "rentalContactPerson": "John Doe",
    "rentalPhone": "+420000000000",
    "rentalEmail": "info@rentall.cz",
    "rentalIco": "00000000",
    "rentalStyle": "commission"
  }
}

Úspěšná odpověď

Stav: 201 Created
Tělo: vytvořený objekt Rent


{
  "id": "684dcbb7a60636d5a2618584",
  "createdAt": "2025-06-14T19:21:27.434Z",
  "updatedAt": "2025-06-14T19:21:27.434Z",
  "basic": {
    "rentalName": "Example Rentals s.r.o.",
    "rentalContactPerson": "John Doe",
    "rentalPhone": "+420000000000",
    "rentalEmail": "info@rentall.cz",
    "rentalIco": "00000000",
    "rentalStyle": "commission"
  }
}

Chyby

400 Bad Request při validační chybě
401/403 při neautorizovaném/zakázaném přístupu

Příklady

curl


curl -s -X POST \
  -H "Authorization: Bearer $RENTALL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "basic": {
      "rentalName": "Example Rentals s.r.o.",
      "rentalContactPerson": "John Doe",
      "rentalPhone": "+420000000000",
      "rentalEmail": "info@rentall.cz",
      "rentalIco": "00000000",
      "rentalStyle": "commission"
    }
  }' \
  https://rentall.cz/api/rents

JavaScript


const token = process.env.RENTALL_TOKEN;
const res = await fetch("https://rentall.cz/api/rents", {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
  body: JSON.stringify({ basic: { rentalName: "Example Rentals s.r.o." } })
});
const created = await res.json();
console.log(created.id);

TypeScript


interface Rent { id: string }
const token = process.env.RENTALL_TOKEN as string;
const res = await fetch("https://rentall.cz/api/rents", {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
  body: JSON.stringify({ basic: { rentalName: "Example Rentals s.r.o." } })
});
const created: Rent = await res.json();
console.log(created.id);

PHP


<?php
$token = getenv('RENTALL_TOKEN');
$payload = json_encode(['basic' => ['rentalName' => 'Example Rentals s.r.o.']]);
$ch = curl_init('https://rentall.cz/api/rents');
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'] ?? '';