מפתחים,מפתחים,מפתחים!
כל מה שיש ב-Makeplans זמין ב-API: REST ו-JSON, webhooks לכל שינוי ושרת MCP לעוזרי 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"
}
}
מוכנים לעבודה תוך דקות
קבלו מפתח API
הפעילו את ה-API תחת הגדרות > אינטגרציות > API והעתיקו את המפתח.
שלחו את הבקשה הראשונה
שלחו את המפתח כ-Bearer token. לכל אובייקט יש endpoint משלו, והכול ב-JSON.
האזינו לשינויים
הוסיפו webhook, ואנחנו נשלח POST לשרת שלכם כשהזמנות, אירועים או לקוחות משתנים.
שני ממשקי API
API ציבורי
בלי מפתח. הציגו שירותים וזמנים פנויים והתחילו הזמנה, ישירות מהאתר שלכם.
https://youraccount.makeplans.com/
API פרטי
גישה מלאה לחשבון שלכם באמצעות מפתח API, לצד השרת ולאינטגרציות. אל תחשפו את המפתח בקוד ציבורי.
https://youraccount.makeplans.com/api/v1/
שלבו את Makeplans במערכת הפנימית או באתר שלכם
כל היכולות של Makeplans זמינות דרך ה-API. זהו API מבוסס REST עם JSON. אנחנו יכולים גם לשלוח webhooks.
חברו את עוזר ה-AI שלכם (MCP)
Makeplans מספקת שרת MCP, כך שעוזרי AI כמו Claude ו-ChatGPT יכולים לעבוד עם ההזמנות שלכם. בקשו מהעוזר לבדוק זמינות, לחפש לקוח או ליצור ולבטל הזמנות – עם פרטי הגישה שלכם ל-Makeplans.
MCP (Model Context Protocol) הוא תקן פתוח. כל עוזר או סוכן שתומך ב-MCP יכול להתחבר – בלי תוסף קנייני ובלי תלות בספק, בדיוק כמו בכל דבר אחר שאנחנו בונים.
הכלים שהעוזר שלכם מקבל
find_available_slotslist_serviceslist_eventslist_bookingsget_bookingfind_customercreate_bookingcancel_booking
חברו את Claude Code בשורה אחת
claude mcp add --transport http makeplans \ https://youraccount.makeplans.com/api/mcp \ --header "Authorization: Bearer $MAKEPLANS_API_KEY"
קראו עוד על עוזר ה-AI להזמנות שלנו.
Webhooks לכל שינוי
כשהזמנה נוצרת, מאושרת, מועברת או מבוטלת, אנחנו שולחים POST לשרת שלכם, חתום ב-HMAC SHA-256, כדי שתדעו שזה הגיע מאיתנו. גם Zapier ו-Make יכולים לקלוט אותו.
התאמה אישית של אתר ההזמנות הסטנדרטי
אפשר להתאים את אתר ההזמנות הסטנדרטי באמצעות CSS משלכם. בנוסף אפשר להתאים טפסים ואת כל ההודעות היוצאות בעזרת שפת התבניות Liquid.
// לחצו על ערך כדי לשנות אותו
אינטגרציות מובנות
ב-Makeplans כבר יש מגוון אינטגרציות מובנות. למידע נוסף ראו את עמוד האינטגרציות. מעבר לאינטגרציות הישירות, יש לנו גם חיבור לפלטפורמות האינטגרציה Zapier ו-Make, שמאפשרות להתחבר לאפליקציות אחרות בלי לכתוב קוד.
ייצוא נתונים
אנחנו מאפשרים לייצא הזמנות, לקוחות ואירועים בפורמט CSV, בהורדה פשוטה.
פידים של iCalendar
כדי להציג תורים מ-Makeplans באפליקציות יומן אחרות אנחנו מציעים פיד iCalendar, שאפשר להשתמש בו ב-Google Calendar, ביומן של macOS, ביומן של iOS, ב-Android, ב-Outlook ובאפליקציות יומן נוספות.