Programiści,programiści,programiści!
Wszystko, co jest w Makeplans, jest też w API: REST i JSON, webhooki dla każdej zmiany oraz serwer MCP dla asystentów AI.
- 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"
}
}
Gotowe w kilka minut
Pobierz klucz API
Włącz API w sekcji Ustawienia → Integracje → API i skopiuj swój klucz.
Wyślij pierwsze zapytanie
Przekaż klucz jako token Bearer. Każdy obiekt ma własny endpoint, wszystko w formacie JSON.
Nasłuchuj zmian
Dodaj webhook, a wyślemy żądanie POST na Twój serwer, gdy zmienią się rezerwacje, wydarzenia lub klienci.
Dwa API
Publiczne API
Bez klucza. Pokaż usługi i wolne terminy oraz rozpocznij rezerwację bezpośrednio na swojej stronie.
https://youraccount.makeplans.com/
Prywatne API
Pełny dostęp do konta za pomocą klucza API – dla Twojego backendu i integracji. Nie umieszczaj klucza w publicznym kodzie.
https://youraccount.makeplans.com/api/v1/
Zintegruj Makeplans ze swoją wewnętrzną aplikacją lub stroną internetową
Wszystkie funkcje Makeplans są dostępne przez API. To API oparte na REST, korzystające z formatu JSON. Możemy też wysyłać webhooki.
Podłącz swojego asystenta AI (MCP)
Makeplans udostępnia serwer MCP, dzięki któremu asystenci AI, tacy jak Claude i ChatGPT, mogą pracować z Twoimi rezerwacjami. Poproś asystenta o sprawdzenie dostępności, wyszukanie klienta albo utworzenie lub anulowanie rezerwacji – z użyciem Twoich własnych danych logowania do Makeplans.
MCP (Model Context Protocol) to otwarty standard. Połączyć może się każdy asystent lub agent obsługujący MCP – bez zamkniętych wtyczek i bez uzależnienia od dostawcy, tak jak wszystko, co budujemy.
Narzędzia, które dostaje Twój asystent
find_available_slotslist_serviceslist_eventslist_bookingsget_bookingfind_customercreate_bookingcancel_booking
Podłącz Claude Code jedną linijką
claude mcp add --transport http makeplans \ https://youraccount.makeplans.com/api/mcp \ --header "Authorization: Bearer $MAKEPLANS_API_KEY"
Dowiedz się więcej o naszym asystencie rezerwacji AI.
Webhooki dla każdej zmiany
Gdy rezerwacja zostanie utworzona, potwierdzona, przeniesiona lub anulowana, wysyłamy żądanie POST na Twój serwer, podpisane HMAC SHA-256, żeby mieć pewność, że pochodzi od nas. Mogą je odbierać także Zapier i Make.
Dostosowanie standardowej strony rezerwacji
Standardową stronę rezerwacji można dostosować za pomocą własnego CSS. Dodatkowo możesz dostosować formularze i wszystkie wiadomości wychodzące, korzystając z języka szablonów Liquid.
// Kliknij wartość, aby ją zmienić
Wbudowane integracje
Makeplans ma już sporo wbudowanych integracji. Więcej informacji znajdziesz na naszej stronie integracji. Oprócz integracji bezpośrednich współpracujemy też z platformami integracyjnymi Zapier i Make, które pozwalają łączyć się z innymi aplikacjami bez programowania.
Eksport danych
Rezerwacje, klientów i wydarzenia możesz w każdej chwili wyeksportować i pobrać w formacie CSV.
Kanały iCalendar
Aby wyświetlać rezerwacje z Makeplans w innych aplikacjach kalendarza, udostępniamy kanał iCalendar, z którego można korzystać w Google Calendar, w Kalendarzu w systemach macOS i iOS, w systemie Android, w programie Outlook i w innych aplikacjach kalendarza.
Zajrzyj do dokumentacji
Naszą dokumentację API znajdziesz pod adresem developer.makeplans.com.