התחלה מהירה

Base URL: https://api.mbapps.co.il/parse. אימות בשני headers: X-Parse-Application-Id ו‑X-Parse-API-Key.

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

שלב 1 · הפיקו Application Id ו‑API Key

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

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

API Key: 38 תווים, שלוש קבוצות הקסדצימליות מופרדות במקפים. תבנית שונה מזו של ה‑Master Key.

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

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

שלב 2 · ספירה ושליפה

GET /parse/classes/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 · קראו את הסכימה לפני שאתם כותבים

GET /parse/schemas/<Table>. כל מערכת היא מופע נפרד עם שדות מותאמים, שדות שהוסרו ותוויות ששונו. אל תניחו שם שדה.

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

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

POST /parse/classes/<Table> עם Content-Type: application/json.

השאלה	התשובה
לאיזו טבלה?	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 שטוחה. אובייקט {"__type":"Pointer",…} בשדה table_<Field> מחזיר 200 OK ושדה ריק, בלי שגיאה. בשדות account_<Field> האובייקט העטוף כן מתקבל, ו‑{"__type":"Date",…} מתקבל בשתי הצורות. בכיוון ההפוך, מחרוזת חשופה ב‑REST נדחית ב‑{"code":111,"error":"schema mismatch for Tasks.Date; expected Date but got String"}. טבלת ההמרה בין שלוש השכבות.

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

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

טופס באתר: לא דרך REST

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

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): בדקו קודם את שם הפונקציה, getlead ולא “web2lead” מהחומרים הישנים. שם נכון ועדיין 400 = הפונקציה אינה רשומה באותה מערכת, ואין דגל 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 יושב לפני בדיקת ההרשאות. מה שכן נפתח הוא הקריאה האנונימית, כלומר התיקון חושף את הטבלה לעולם ועדיין לא מאפשר את הכתיבה.

המשך מכאן

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