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.
- 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.
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_slotslist_serviceslist_eventslist_bookingsget_bookingfind_customercreate_bookingcancel_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.
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.
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 a všechny odchozí zprávy.
// Kliknutím na hodnotu ji změníte
Vestavěné integrace
Makeplans má řadu integrací už vestavěných. Více najdete na naší stránce integrací. Kromě přímých integrací jsme napojeni také na integrační platformy Zapier a 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.