# Vývojáři,vývojáři,vývojáři!

V API najdete všechno, co Makeplans umí: REST a JSON, webhooky pro každou změnu a MCP server pro AI asistenty.

[Dokumentace API](https://developer.makeplans.com)

- REST + JSON
- Webhooks
- MCP
- iCal
- CSV

```
$ curl https://youraccount.makeplans.com/api/v1/services/42/slots?from=2026-11-19 \
  -H 'Authorization: Bearer $MAKEPLANS_API_KEY' \
  -H 'User-Agent: MyApp' \
  -H 'Accept: application/json'
[
  {
    "slot": {
      "timestamp": "2026-11-19T10:30:00+01:00",
      "timestamp_end": "2026-11-19T11:30:00+01:00",
      "free": 1,
      "available_resources": [1, 2],
      "maximum_capacity": 2
    }
  },
  {
    "slot": {
      "timestamp": "2026-11-19T13:00:00+01:00",
      "timestamp_end": "2026-11-19T14:00:00+01:00",
      "free": 2,
      "available_resources": [1, 2],
      "maximum_capacity": 2
    }
  }
]$ curl https://youraccount.makeplans.com/api/v1/bookings -X POST \
  -H 'Authorization: Bearer $MAKEPLANS_API_KEY' \
  -H 'User-Agent: MyApp' \
  -H 'Accept: application/json' \
  -d 'booking[service_id]=42' \
  -d 'booking[resource_id]=1' \
  -d 'booking[booked_from]=2026-11-19T10:30:00+01:00' \
  -d 'booking[booked_to]=2026-11-19T11:30:00+01:00'
{
  "booking": {
    "id": 1337,
    "state": "confirmed",
    "service_id": 42,
    "resource_id": 1,
    "booked_from": "2026-11-19T10:30:00+01:00",
    "booked_to": "2026-11-19T11:30:00+01:00"
  }
}
```

```
curl https://youraccount.makeplans.com/api/v1/services/42/slots?from=2026-11-19 \
  -H 'Authorization: Bearer $MAKEPLANS_API_KEY' \
  -H 'User-Agent: MyApp' \
  -H 'Accept: application/json'
```

```
[
  {
    "slot": {
      "timestamp": "2026-11-19T10:30:00+01:00",
      "timestamp_end": "2026-11-19T11:30:00+01:00",
      "free": 1,
      "available_resources": [1, 2],
      "maximum_capacity": 2
    }
  },
  {
    "slot": {
      "timestamp": "2026-11-19T13:00:00+01:00",
      "timestamp_end": "2026-11-19T14:00:00+01:00",
      "free": 2,
      "available_resources": [1, 2],
      "maximum_capacity": 2
    }
  }
]
```

```
# 10:30 is free. Book it.
```

```
curl https://youraccount.makeplans.com/api/v1/bookings -X POST \
  -H 'Authorization: Bearer $MAKEPLANS_API_KEY' \
  -H 'User-Agent: MyApp' \
  -H 'Accept: application/json' \
  -d 'booking[service_id]=42' \
  -d 'booking[resource_id]=1' \
  -d 'booking[booked_from]=2026-11-19T10:30:00+01:00' \
  -d 'booking[booked_to]=2026-11-19T11:30:00+01:00'
```

```
{
  "booking": {
    "id": 1337,
    "state": "confirmed",
    "service_id": 42,
    "resource_id": 1,
    "booked_from": "2026-11-19T10:30:00+01:00",
    "booked_to": "2026-11-19T11:30:00+01:00"
  }
}
```

```
const api = "https://youraccount.makeplans.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.MAKEPLANS_API_KEY}`,
  "User-Agent": "MyApp",
  Accept: "application/json",
};

// Find the first free slot
const slots = await fetch(`${api}/services/42/slots?from=2026-11-19`, { headers })
  .then((res) => res.json());
const { slot } = slots.find(({ slot }) => slot.free > 0);

// Book it
const booking = await fetch(`${api}/bookings`, {
  method: "POST",
  headers,
  body: new URLSearchParams({
    "booking[service_id]": "42",
    "booking[resource_id]": String(slot.available_resources[0]),
    "booking[booked_from]": slot.timestamp,
    "booking[booked_to]": slot.timestamp_end,
  }),
}).then((res) => res.json());

console.log(booking);
```

```
{
  "booking": {
    "id": 1337,
    "state": "confirmed",
    "service_id": 42,
    "resource_id": 1,
    "booked_from": "2026-11-19T10:30:00+01:00",
    "booked_to": "2026-11-19T11:30:00+01:00"
  }
}
```

```
require "net/http"
require "json"

API = "https://youraccount.makeplans.com/api/v1"

def makeplans(request)
  request["Authorization"] = "Bearer #{ENV.fetch('MAKEPLANS_API_KEY')}"
  request["User-Agent"] = "MyApp"
  request["Accept"] = "application/json"
  uri = request.uri
  response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(request) }
  JSON.parse(response.body)
end

# Find the first free slot
slots = makeplans(Net::HTTP::Get.new(URI("#{API}/services/42/slots?from=2026-11-19")))
slot = slots.map { |s| s["slot"] }.find { |s| s["free"] > 0 }

# Book it
post = Net::HTTP::Post.new(URI("#{API}/bookings"))
post.set_form_data(
  "booking[service_id]" => 42,
  "booking[resource_id]" => slot["available_resources"].first,
  "booking[booked_from]" => slot["timestamp"],
  "booking[booked_to]" => slot["timestamp_end"]
)
puts makeplans(post)
```

```
{
  "booking": {
    "id": 1337,
    "state": "confirmed",
    "service_id": 42,
    "resource_id": 1,
    "booked_from": "2026-11-19T10:30:00+01:00",
    "booked_to": "2026-11-19T11:30:00+01:00"
  }
}
```

```
import os
import requests

API = "https://youraccount.makeplans.com/api/v1"
session = requests.Session()
session.headers.update({
    "Authorization": f"Bearer {os.environ['MAKEPLANS_API_KEY']}",
    "User-Agent": "MyApp",
    "Accept": "application/json",
})

# Find the first free slot
slots = session.get(f"{API}/services/42/slots", params={"from": "2026-11-19"}).json()
slot = next(s["slot"] for s in slots if s["slot"]["free"] > 0)

# Book it
booking = session.post(f"{API}/bookings", data={
    "booking[service_id]": 42,
    "booking[resource_id]": slot["available_resources"][0],
    "booking[booked_from]": slot["timestamp"],
    "booking[booked_to]": slot["timestamp_end"],
}).json()
print(booking)
```

```
{
  "booking": {
    "id": 1337,
    "state": "confirmed",
    "service_id": 42,
    "resource_id": 1,
    "booked_from": "2026-11-19T10:30:00+01:00",
    "booked_to": "2026-11-19T11:30:00+01:00"
  }
}
```

## Hotovo za pár minut

### Získejte API klíč

Zapněte API v sekci Nastavení → Integrace → API a zkopírujte si klíč.

### Pošlete první požadavek

Klíč posílejte jako Bearer token. Každý objekt má vlastní endpoint a všechno je v JSON.

### Sledujte změny

Přidejte webhook a my pošleme POST na váš server, kdykoli se změní rezervace, události nebo zákazníci.

## Dvě API

### Veřejné API

Bez klíče. Zobrazte služby a volné termíny a zahajte rezervaci přímo na svém webu.

`https://youraccount.makeplans.com/`

### Soukromé API

Plný přístup k vašemu účtu pomocí API klíče, pro váš backend a integrace. Klíč nikdy nedávejte do veřejného kódu.

`https://youraccount.makeplans.com/api/v1/`

## Propojte Makeplans se svou interní aplikací nebo webem

Všechny funkce Makeplans jsou dostupné i přes API. Jde o API typu REST s formátem JSON. Umíme posílat i webhooky.

- [Slots](https://developer.makeplans.com/endpoints/slots/)
- [Bookings](https://developer.makeplans.com/endpoints/bookings/)
- [People](https://developer.makeplans.com/endpoints/people/)
- [Services](https://developer.makeplans.com/endpoints/services/)
- [Events](https://developer.makeplans.com/endpoints/events/)
- [Resources](https://developer.makeplans.com/endpoints/resources/)
- [Resource Exception Dates](https://developer.makeplans.com/endpoints/resource-exception-dates/)
- [Providers](https://developer.makeplans.com/endpoints/providers/)
- [Categories](https://developer.makeplans.com/endpoints/categories/)
- [Coupons](https://developer.makeplans.com/endpoints/coupons/)
- [Orders](https://developer.makeplans.com/endpoints/orders/)
- [Gift Cards](https://developer.makeplans.com/endpoints/gift-cards/)
- [Message Templates](https://developer.makeplans.com/endpoints/message-templates/)
- [Webhooks](https://developer.makeplans.com/endpoints/webhooks/)
- [Account](https://developer.makeplans.com/endpoints/account/)
- [Passes](https://developer.makeplans.com/endpoints/passes/)
- [Subscriptions](https://developer.makeplans.com/endpoints/subscriptions/)
- [Zobrazit všechny endpointy](https://developer.makeplans.com/endpoints/)

## Připojte svého AI asistenta (MCP)

Makeplans nabízí MCP server, takže AI asistenti jako Claude a ChatGPT mohou pracovat s vašimi rezervacemi. Požádejte asistenta, ať zkontroluje volné termíny, vyhledá zákazníka nebo vytvoří či zruší rezervaci – s vašimi vlastními přihlašovacími údaji k Makeplans.

MCP (Model Context Protocol) je otevřený standard. Připojit se může jakýkoli asistent nebo agent, který MCP ovládá – bez proprietárního pluginu a bez závislosti na jednom dodavateli, stejně jako u všeho ostatního, co tvoříme.

### Nástroje, které váš asistent dostane

- `find_available_slots`
- `list_services`
- `list_events`
- `list_bookings`
- `get_booking`
- `find_customer`
- `create_booking`
- `cancel_booking`

### Připojte Claude Code jedním řádkem

```
claude mcp add --transport http makeplans \
  https://youraccount.makeplans.com/api/mcp \
  --header "Authorization: Bearer $MAKEPLANS_API_KEY"
```

Přečtěte si více o našem [AI rezervačním asistentovi](/cs/reseni/ai-rezervacni-asistent/).

Objednej Annu na masáž v pátek ve 14:00

Najdu službu masáž a vyhledám Annu.

M`list_services`

```
→{}←[{"id": 42, "title": "Massage", "interval": 60}]
```

M`find_customer`

```
→{"query": "Anna"}←[{"id": 7, "name": "Anna Nordmann"}]
```

M`find_available_slots`

```
→{"service_id": 42, "from": "2026-11-13"}←[{"timestamp": "2026-11-13T14:00:00+01:00", "free": 1}]
```

M`create_booking`

```
→{"service_id": 42, "person_id": 7, "booked_from": "2026-11-13T14:00:00+01:00"}←{"id": 1338, "state": "confirmed"}
```

Rezervováno: Anna Nováková, masáž v pátek ve 14:00. Dostane potvrzení i připomenutí.

## Webhooky pro každou změnu

Když se rezervace vytvoří, potvrdí, přesune nebo zruší, pošleme ji metodou POST na váš server, podepsanou pomocí HMAC SHA-256, abyste věděli, že přišla od nás. Zachytit ji umí i Zapier a Make.

Mmakeplans

{ }your server

Zapier

Make

POST https://example.com/webhooks

```
X-MakePlans-Signature: sha256=5257a869e7ec…{
  "event": "booking.created",
  "idempotency_id": "evt_4810",
  "generated_at": "2026-11-12T02:37:29Z",
  "performed_by": "customer",
  "data": {
    "object": "booking",
    "id": 1337,
    "booking": { "id": 1337, "state": "confirmed" }
  }
}
```

tail -f webhooks.log

```
02:37:29 POST /webhooks **booking.created** _200 OK_signature ✓
```

## Přizpůsobení standardního rezervačního webu

Standardní rezervační web si můžete přizpůsobit vlastním CSS. Navíc lze pomocí šablonovacího jazyka Liquid [upravit formuláře](https://github.com/makeplans/makeplans-custom-forms) a všechny [odchozí zprávy](https://github.com/makeplans/makeplans-custom-messages).

custom.css

.booking-site {--accent: #2a8c8f;--background: #f1f8f8;--text: #173f44;--soft: #d9ecec;--radius: 14px;--font: "Avenir Next", sans-serif;}

// Kliknutím na hodnotu ji změníte

 Vaše firma Váš rezervační web, váš styl 

**12**** 13 ****14**** 15**

09:0010:3011:0013:0014:3016:00
Rezervovat

### Vestavěné integrace

Makeplans má řadu integrací už vestavěných. Více najdete na naší [stránce integrací](/cs/integrace/). Kromě přímých integrací jsme napojeni také na integrační platformy [Zapier](/cs/integrace/zapier/) a [Make](/cs/integrace/make/), díky kterým se propojíte s dalšími aplikacemi bez programování.

### Export dat

Rezervace, zákazníky a události si můžete snadno stáhnout ve formátu CSV.

### iCalendar feedy

Chcete termíny z Makeplans vidět i v jiných kalendářích? Nabízíme iCalendar feed, který můžete použít v aplikacích Google Calendar a Outlook, v kalendáři systémů macOS, iOS a Android i v dalších kalendářových aplikacích.

## Ponořte se do dokumentace

- [Průvodce](https://developer.makeplans.com/guide/getting-started/)
- [Endpointy API](https://developer.makeplans.com/endpoints/)
- [Příklady](https://developer.makeplans.com/examples/overview/)
- [Seznam změn](https://developer.makeplans.com/changelog/)
- [Partnerské API](https://developer.makeplans.com/partner/)

Naši [dokumentaci API najdete na developer.makeplans.com](https://developer.makeplans.com).