התחלה מהירה

המסלול הקצר ביותר מ“אין לי כלום” ל“קיבלתי JSON מהמערכת שלי”.

רגע לפני — לאיזו מערכת אתם מתחברים?

כל לקוח הוא אפליקציה נפרדת עם מזהה ומפתחות משלה, וההפרדה בין אפליקציית ה‑CRM שהמשתמשים עובדים בה לבין סביבת הפיתוח שממנה מוציאים את הפרטים מבלבלת כמעט כל אחד בפעם הראשונה. שתי דקות שיחסכו רבע שעה: סביבות וגישה.

שלב 1 · הוציאו Application Id ו‑API Key

שני הערכים נמצאים באותו מסך, ואתם מפיקים אותם בעצמכם; אין צורך לפנות לתמיכה.

1. בתוך ה‑CRM פתחו את תפריט המשתמש (למעלה מימין) ובחרו סביבת פיתוח — נפתחת לשונית חדשה ב‑siteadmin.mbapps.co.il.
2. שם: Databases ← בחרו את המערכת שלכם ← לשונית Settings.
3. Application Id — יש כפתור העתקה לצד הערך.
4. API Keys — לחצו + Add Key. המפתח נוצר ומוצג מיד בשורה חדשה; הקלידו לו שם ולחצו Save כדי לשמור. אחרי רענון תראו את השורה עם ה‑Created Date.

המפתח שנוצר הוא באורך 38 תווים, בשלוש קבוצות הקסדצימליות מופרדות במקפים — לא באותה תבנית כמו ה‑Master Key.

ה‑API Key הוא לא מפתח מוגבל

המפתח מגיע לכל טבלה ולכל רשומה, כולל _User, והכתיבות שלו נרשמות בשם המשתמש Master, בדיוק כמו Master Key. מה שכן מקבלים ממנו: ביטול נקודתי (אייקון הפח בעמודת Revoke של השורה, עם חלון אישור) בלי לגעת בשום דבר אחר — ומרגע האישור המפתח מת: הקריאה הבאה איתו מוחזרת ב‑{"code":119,"error":"Permission denied for action find on class …"}, בעוד שאר המפתחות ממשיכים לעבוד. כשצריך גבול הרשאות אמיתי, השתמשו בהתחברות משתמש עם Session Token.

תנו למפתח שם

שדה ה‑Name נשמר ומוצג לצד תאריך היצירה. הוא מה שיאפשר לכם, בעוד חצי שנה, לבטל (Revoke) את המפתח הנכון בלי להפיל שירות אחר.

שלב 2 · הקריאה הראשונה

בדיקה ראשונה שהחיבור עובד: כמה לידים ולקוחות יש בטבלה המרכזית Accounts.

Bash

APP_ID="הדביקו-כאן"
API_KEY="הדביקו-כאן"

curl -sS -G "https://api.mbapps.co.il/parse/classes/Accounts" \
  -H "X-Parse-Application-Id: $APP_ID" \
  -H "X-Parse-API-Key: $API_KEY" \
  --data-urlencode 'limit=0' \
  --data-urlencode 'count=1'

JavaScript

const APP_ID = "הדביקו-כאן";
const API_KEY = "הדביקו-כאן";

const params = new URLSearchParams({ limit: "0", count: "1" });
const res = await fetch(`https://api.mbapps.co.il/parse/classes/Accounts?${params}`, {
  headers: {
    "X-Parse-Application-Id": APP_ID,
    "X-Parse-API-Key": API_KEY,
  },
});
const data = await res.json();

Python

import requests

APP_ID = "הדביקו-כאן"
API_KEY = "הדביקו-כאן"

res = requests.get(
    "https://api.mbapps.co.il/parse/classes/Accounts",
    headers={
        "X-Parse-Application-Id": APP_ID,
        "X-Parse-API-Key": API_KEY,
    },
    params={"limit": 0, "count": 1},
)
data = res.json()

PHP

$appId = "הדביקו-כאן";
$apiKey = "הדביקו-כאן";

$query = http_build_query(["limit" => 0, "count" => 1]);
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.mbapps.co.il/parse/classes/Accounts?" . $query,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-Parse-Application-Id: $appId",
        "X-Parse-API-Key: $apiKey",
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

תשובה תקינה:

JSON

{ "results": [], "count": 1843 }

עכשיו שלוש רשומות אמיתיות, רק עם השדות שמעניינים אתכם:

Bash

curl -sS -G "https://api.mbapps.co.il/parse/classes/Accounts" \
  -H "X-Parse-Application-Id: $APP_ID" \
  -H "X-Parse-API-Key: $API_KEY" \
  --data-urlencode 'keys=Name,PhoneNumber,Email,IsAccount' \
  --data-urlencode 'order=-createdAt' \
  --data-urlencode 'limit=3'

JavaScript

const APP_ID = "הדביקו-כאן";
const API_KEY = "הדביקו-כאן";

const params = new URLSearchParams({
  keys: "Name,PhoneNumber,Email,IsAccount",
  order: "-createdAt",
  limit: "3",
});
const res = await fetch(`https://api.mbapps.co.il/parse/classes/Accounts?${params}`, {
  headers: {
    "X-Parse-Application-Id": APP_ID,
    "X-Parse-API-Key": API_KEY,
  },
});
const data = await res.json();

Python

import requests

APP_ID = "הדביקו-כאן"
API_KEY = "הדביקו-כאן"

res = requests.get(
    "https://api.mbapps.co.il/parse/classes/Accounts",
    headers={
        "X-Parse-Application-Id": APP_ID,
        "X-Parse-API-Key": API_KEY,
    },
    params={
        "keys": "Name,PhoneNumber,Email,IsAccount",
        "order": "-createdAt",
        "limit": 3,
    },
)
data = res.json()

PHP

$appId = "הדביקו-כאן";
$apiKey = "הדביקו-כאן";

$query = http_build_query([
    "keys" => "Name,PhoneNumber,Email,IsAccount",
    "order" => "-createdAt",
    "limit" => 3,
]);
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.mbapps.co.il/parse/classes/Accounts?" . $query,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-Parse-Application-Id: $appId",
        "X-Parse-API-Key: $apiKey",
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

JSON

{
  "results": [
    {
      "objectId": "xK9mP2qRsT",
      "Name": "ישראל ישראלי",
      "PhoneNumber": "0501234567",
      "Email": "israel@example.co.il",
      "IsAccount": false,
      "createdAt": "2026-08-20T06:12:44.109Z",
      "updatedAt": "2026-08-20T06:12:44.109Z"
    }
  ]
}

IsAccount: false = ליד. IsAccount: true = לקוח. שניהם יושבים באותה טבלה; ראו מוסכמות המוצר.

שתי מלכודות שכבר עברתם עליהן בלי לשים לב

• לא ציינתם limit? הייתם מקבלים בדיוק 100 שורות — זו ברירת המחדל של REST, לא גודל הטבלה.
• where הוא JSON שצריך לעבור קידוד URL. --data-urlencode עשה זאת בשבילכם. בלי קידוד, כל תו מיוחד נכשל בדרך אחרת: + הופך לרווח והשאילתה חוזרת 200 עם מערך ריק — בלי שגיאה; & חותך את ה‑JSON ומוחזר 400 עם {"code":102,"error":"Invalid parameter for query: …"}; # נבלע כ‑fragment עוד בצד הלקוח, וה‑JSON הקטוע שמגיע לשרת מוחזר ב‑500 Internal server error.

הפירוט המלא: שאילתות.

שלב 3 · קראו את הסכימה לפני שאתם כותבים

זה הצעד שחוסך את רוב התקלות: כל מערכת היא מופע נפרד עם שדות מותאמים, שדות שהוסרו ותוויות ששונו. אל תניחו שם שדה; שאלו.

Bash

curl -sS "https://api.mbapps.co.il/parse/schemas/Accounts" \
  -H "X-Parse-Application-Id: $APP_ID" \
  -H "X-Parse-API-Key: $API_KEY"

JavaScript

const APP_ID = "הדביקו-כאן";
const API_KEY = "הדביקו-כאן";

const res = await fetch("https://api.mbapps.co.il/parse/schemas/Accounts", {
  headers: {
    "X-Parse-Application-Id": APP_ID,
    "X-Parse-API-Key": API_KEY,
  },
});
const data = await res.json();

Python

import requests

APP_ID = "הדביקו-כאן"
API_KEY = "הדביקו-כאן"

res = requests.get(
    "https://api.mbapps.co.il/parse/schemas/Accounts",
    headers={
        "X-Parse-Application-Id": APP_ID,
        "X-Parse-API-Key": API_KEY,
    },
)
data = res.json()

PHP

$appId = "הדביקו-כאן";
$apiKey = "הדביקו-כאן";

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.mbapps.co.il/parse/schemas/Accounts",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-Parse-Application-Id: $appId",
        "X-Parse-API-Key: $apiKey",
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

JSON

{
  "className": "Accounts",
  "fields": {
    "objectId":    { "type": "String" },
    "Name":        { "type": "String" },
    "PhoneNumber": { "type": "String" },
    "Email":       { "type": "String" },
    "IsAccount":   { "type": "Boolean" },
    "LeadStatusId":{ "type": "Pointer", "targetClass": "LeadStatuses" },
    "LeadSourceId":{ "type": "Pointer", "targetClass": "LeadSource" },
    "createdAt":   { "type": "Date" }
  },
  "classLevelPermissions": { "find": {}, "get": {}, "create": {} },
  "triggers": [],
  "timeline": { "displayFields": {}, "index": {} }
}

מה יש בתשובת הסכימה מעבר ל‑fields

classLevelPermissions הוא חלק סטנדרטי מתשובת הסכימה של Parse Server (יחד עם indexes), ולא ייחודי כאן — אבל הוא עדיין התחנה הראשונה כש“המשתמש לא רואה כלום”. מה שכן ייחודי למערכת: triggers (הגדרות האוטומציה נשמרות יחד עם הסכימה), timeline — שמופיע רק בטבלאות שציר הזמן שלהן דלוק — ושתי מפות ההרשאות ברמת הנתונים, datapermissions ו‑dataPositivePermissions, שחוזרות בתשובה ואינן קיימות ב‑Parse הגנרי. אם כתיבה שלכם “עושה דברים מוזרים”, triggers הוא המקום הראשון להסתכל בו.

הרחבה: סכימות — לקרוא לפני שכותבים.

שלב 4 · יצירת רשומה

לפני שאתם שולחים — שתי החלטות שכדאי לקבל בעיניים פקוחות:

השאלה	התשובה
לאיזו טבלה?	Accounts ללקוחות ולידים, Sales לעסקאות, Cases לפניות, Tasks למשימות. המפה המלאה: מפת הטבלאות
באיזה פורמט?	String וגם Number פשוטים. Pointer ו‑Date נכתבים אחרת בכל שכבה: סוגי נתונים

Bash

curl -sS -X POST "https://api.mbapps.co.il/parse/classes/Accounts" \
  -H "X-Parse-Application-Id: $APP_ID" \
  -H "X-Parse-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"Name":"בדיקה מה-API","PhoneNumber":"0500000000","IsAccount":false}'

JavaScript

const APP_ID = "הדביקו-כאן";
const API_KEY = "הדביקו-כאן";

const res = await fetch("https://api.mbapps.co.il/parse/classes/Accounts", {
  method: "POST",
  headers: {
    "X-Parse-Application-Id": APP_ID,
    "X-Parse-API-Key": API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    Name: "בדיקה מה-API",
    PhoneNumber: "0500000000",
    IsAccount: false,
  }),
});
const data = await res.json();

Python

import requests

APP_ID = "הדביקו-כאן"
API_KEY = "הדביקו-כאן"

res = requests.post(
    "https://api.mbapps.co.il/parse/classes/Accounts",
    headers={
        "X-Parse-Application-Id": APP_ID,
        "X-Parse-API-Key": API_KEY,
        "Content-Type": "application/json",
    },
    json={
        "Name": "בדיקה מה-API",
        "PhoneNumber": "0500000000",
        "IsAccount": False,
    },
)
data = res.json()

PHP

$appId = "הדביקו-כאן";
$apiKey = "הדביקו-כאן";

$payload = json_encode([
    "Name" => "בדיקה מה-API",
    "PhoneNumber" => "0500000000",
    "IsAccount" => false,
]);
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.mbapps.co.il/parse/classes/Accounts",
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-Parse-Application-Id: $appId",
        "X-Parse-API-Key: $apiKey",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
curl_close($ch);

JSON

{ "objectId": "Cpl9lrueY5", "createdAt": "2026-08-20T07:41:02.311Z" }

objectId הוא תמיד מחרוזת באורך 10 תווים. שמרו אותו: הוא המפתח לכל עדכון, מחיקה או קישור עתידי.

עכשיו קשרו משהו אליו. שימו לב לצורה של ה‑Pointer:

Bash

curl -sS -X POST "https://api.mbapps.co.il/parse/classes/Tasks" \
  -H "X-Parse-Application-Id: $APP_ID" \
  -H "X-Parse-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "Name": "התקשר ללקוח",
        "Date": { "__type": "Date", "iso": "2026-09-01T08:00:00.000Z" },
        "AccountId": { "__type": "Pointer", "className": "Accounts", "objectId": "Cpl9lrueY5" }
      }'

JavaScript

const APP_ID = "הדביקו-כאן";
const API_KEY = "הדביקו-כאן";

const res = await fetch("https://api.mbapps.co.il/parse/classes/Tasks", {
  method: "POST",
  headers: {
    "X-Parse-Application-Id": APP_ID,
    "X-Parse-API-Key": API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    Name: "התקשר ללקוח",
    Date: { __type: "Date", iso: "2026-09-01T08:00:00.000Z" },
    AccountId: { __type: "Pointer", className: "Accounts", objectId: "Cpl9lrueY5" },
  }),
});
const data = await res.json();

Python

import requests

APP_ID = "הדביקו-כאן"
API_KEY = "הדביקו-כאן"

res = requests.post(
    "https://api.mbapps.co.il/parse/classes/Tasks",
    headers={
        "X-Parse-Application-Id": APP_ID,
        "X-Parse-API-Key": API_KEY,
        "Content-Type": "application/json",
    },
    json={
        "Name": "התקשר ללקוח",
        "Date": {"__type": "Date", "iso": "2026-09-01T08:00:00.000Z"},
        "AccountId": {"__type": "Pointer", "className": "Accounts", "objectId": "Cpl9lrueY5"},
    },
)
data = res.json()

PHP

$appId = "הדביקו-כאן";
$apiKey = "הדביקו-כאן";

$payload = json_encode([
    "Name" => "התקשר ללקוח",
    "Date" => ["__type" => "Date", "iso" => "2026-09-01T08:00:00.000Z"],
    "AccountId" => ["__type" => "Pointer", "className" => "Accounts", "objectId" => "Cpl9lrueY5"],
]);
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.mbapps.co.il/parse/classes/Tasks",
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-Parse-Application-Id: $appId",
        "X-Parse-API-Key: $apiKey",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
curl_close($ch);

הצורה הזו נכונה ל‑REST — בשכבת הטפסים הצורה אחרת

באותה בקשה בדיוק דרך getlead או web2table, Pointer הוא מחרוזת objectId חשופה ותאריך הוא מחרוזת ISO שטוחה. מי שמעתיק snippet של REST לטופס אתר ושולח אובייקט {"__type":"Pointer",…} בשדה table_<Field> יקבל 200 OK ושדה ריק — בלי שגיאה, בלי אזהרה. בשדות account_<Field> האובייקט העטוף דווקא מתקבל, ואובייקט {"__type":"Date",…} מתקבל בשתי הצורות. וההפך: מחרוזת חשופה ב‑REST נדחית ב‑{"code":111,"error":"schema mismatch for Tasks.Date; expected Date but got String"}. טבלת ההמרה המלאה: סוגי נתונים והפורמט ב‑JSON.

הכתיבה הזו הפעילה אוטומציות

כל כתיבה — גם בדיקה תמימה — מפעילה טריגרים מסוג data change. ברשומה אחת זה בדרך כלל שקוף; בטעינה של אלפי רשומות זו סופה של מיילים והודעות ללקוחות אמיתיים. ראו מגבלות ומכסות.

אבל רגע — אם זה טופס באתר, אל תעשו את זה

הקריאה שלמעלה דורשת מפתח. מפתח בדפדפן = דלף. לטפסים ציבוריים יש שכבה נפרדת שנועדה בדיוק לזה, בלי סודות בכלל:

JavaScript

await fetch(`https://api.mbapps.co.il/functions/${APP_ID}/getlead`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-Parse-Application-Id': APP_ID },
  body: JSON.stringify({ Name: 'ישראל ישראלי', PhoneNumber: '0501234567' }),
});

ההסבר המלא: getlead ו‑web2table.

בדקו שהפונקציה רשומה במערכת שלכם

נקודות הקצה של הטפסים נרשמות לכל מערכת בנפרד. אם הקריאה מחזירה {"error":"User function not found"} (HTTP 400, גם עם Master Key) — בדקו קודם את שם הפונקציה. נתקלתם בשם web2lead במדריך ישן? הפונקציה הרשומה בשרת היא getlead. אם השם נכון, הפונקציה אינה רשומה באותה מערכת, ואין דגל Config שיפעיל אותה — זו פנייה לתמיכה. שגיאה של חוסר שדה (למשל {"error":"missing \"phone\""}) או … is Disabled (למשל AcceptWebToTable is Disabled, כשדגל ה‑Config כבוי) דווקא מעידה שהפונקציה כן קיימת. ראו דגלי Config.

ניסיון לכתוב אנונימית ישירות ל‑REST ייכשל

POST /parse/classes/<Table> עם X-Parse-Application-Id בלבד (בלי session ובלי master key) נדחה עם {"code":119,"error":"This action is not allowed without a valid CAPTCHA"}. פתיחת ההרשאות (CLP) של הטבלה לא פותרת את זה: גם אחרי create: {"*": true} מלא, הכתיבה עדיין מוחזרת ב‑119. שער ה‑CAPTCHA יושב לפני בדיקת ההרשאות. מה שכן קורה בפתיחת ה‑CLP: הקריאה האנונימית נפתחת. כלומר “התיקון” הזה נותן לעולם לקרוא את הטבלה, ועדיין לא מאפשר את הכתיבה שרציתם.

המשך מכאן

• אימות והרשאות — ארבע שיטות האימות ומתי כל אחת נכונה
• מוסכמות המוצר — למה Accounts מחזיקה גם לידים
• סוגי נתונים — הפורמט ב‑JSON לכל טיפוס, בשלוש השכבות
• מפת הטבלאות — לאיזו טבלה אתם כותבים
• שאילתות — סינון, מיון ועימוד
• שגיאות ופתרון תקלות — מה אומר כל קוד