עבודה עם רשומות — REST API

ה‑API הוא Parse Server.

מפת הנקודות

מה	הכתובת	העמוד
בסיס ה‑API	https://api.mbapps.co.il/parse
רשומות בטבלה	/parse/classes/<Table>	העמוד הזה
שאילתות וסינון	/parse/classes/<Table>?where=…	שאילתות
כמה פעולות בבקשה	/parse/batch	batch
אגרגציה	/parse/classes-aggregate/<Table> — לא /parse/aggregate/	אגרגציות
סכימות	/parse/schemas[/<Table>]	סכימות
משתמשים והתחברות	/parse/users · /parse/login	משתמשים
קבצים	/parse/files/<fileName>	קבצים
פונקציות צד שרת	https://api.mbapps.co.il/functions/{appId}/{fn} — מחוץ ל‑/parse	פונקציות צד שרת

בכל בקשה: X-Parse-Application-Id וכותרת הרשאה (אימות). גוף POST/PUT: JSON, Content-Type: application/json. CORS פתוח: ה‑preflight מחזיר את ה‑Origin ששלחתם (לא *), GET,PUT,POST,DELETE,OPTIONS, וכל כותרות ה‑X-Parse-*. אל תשלחו סוד מהדפדפן.

לפני הקריאה הראשונה

שלפו סכימה ובדקו סוגי נתונים: Pointer ו‑Date נכתבים אחרת בכל שכבה.

CRUD

POST יצירה

POST /parse/classes/{Table}

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": "ישראל ישראלי", "PhoneNumber": "0501234567",
  "Email": "israel@example.co.il", "IsAccount": false }'

JavaScript

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: 'ישראל ישראלי',
    PhoneNumber: '0501234567',
    Email: 'israel@example.co.il',
    IsAccount: false,
  }),
});

Python

import requests

res = requests.post(
    "https://api.mbapps.co.il/parse/classes/Accounts",
    headers={
        "X-Parse-Application-Id": APP_ID,
        "X-Parse-API-Key": API_KEY,
    },
    json={
        "Name": "ישראל ישראלי",
        "PhoneNumber": "0501234567",
        "Email": "israel@example.co.il",
        "IsAccount": False,
    },
    timeout=30,
)

PHP

<?php
$ch = curl_init('https://api.mbapps.co.il/parse/classes/Accounts');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'X-Parse-Application-Id: ' . $appId,
        'X-Parse-API-Key: ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'Name' => 'ישראל ישראלי',
        'PhoneNumber' => '0501234567',
        'Email' => 'israel@example.co.il',
        'IsAccount' => false,
    ], JSON_UNESCAPED_UNICODE),
]);
$response = curl_exec($ch);
curl_close($ch);

201 Created →

JSON

{ "objectId": "xK9mP2qRsT", "createdAt": "2026-01-10T08:30:00.000Z" }

objectId נוצר בשרת, 10 תווים. אל תשלחו אותו ביצירה; שמרו אותו לעדכון, מחיקה וקישור.

עם Master Key השרת מקבל objectId שנשלח בגוף

עם Master Key או API Key, objectId שנשלח ב‑POST מתקבל כמות שהוא בכל אורך. ערך שאינו ASCII מחזיר 500; מזהה קיים מחזיר 400 עם code 137; Session Token דוחה (code 105). שלחו objectId רק בהגירה מכוונת, ואז 10 תווי ASCII: Get-Data ב‑MCP דורש בדיוק 10.

יצירת רשומה מפעילה אוטומציות

כל כתיבה, גם עם Master Key, מפעילה טריגרים מסוג data change: מיילים, WhatsApp, יצירת רשומות נוספות (POST ל‑Accounts עם Master Key מפעיל את טריגר המערכת Lead Conversion Date, וההרצה נרשמת ב‑_syslogTriggers). ברשומה בודדת רצוי; בטעינת אלפי רשומות ראו batch ו‑מגבלות. להשתקה מכוונת של כתיבה בודדת ראו את הדגלים למטה.

GET שליפת רשומה בודדת

GET /parse/classes/{Table}/{objectId}

מחזיר את האובייקט המלא. include=<שדה Pointer> מרחיב את הרשומה המקושרת בתשובה:

HTTP

GET /parse/classes/Tasks/Cpl9lrueY5?include=AccountId

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

PUT עדכון

PUT /parse/classes/{Table}/{objectId}

שלחו רק את השדות שמשתנים; השאר לא נוגעים.

JSON

{
  "LastAction": "ביקש שיחה חוזרת",
  "LastActionDate": { "__type": "Date", "iso": "2026-03-24T10:00:00.000Z" }
}

תשובה: { "updatedAt": "…", "objectId": "…" }.

פעולות אטומיות

אופרטור במקום read‑modify‑write; בטוח גם מול מרוץ בין תהליכים:

JSON

{ "StockCount": { "__op": "Increment", "amount": -5 } }
{ "Tags":       { "__op": "AddUnique", "objects": ["דחוף"] } }
{ "Tags":       { "__op": "Remove",    "objects": ["דחוף"] } }
{ "FieldName":  { "__op": "Delete" } }

Increment מחזיר גם את הערך החדש ({"StockCount":5,"updatedAt":"…","objectId":"…"}); AddUnique לא מכפיל ערך קיים.

__op: "Delete" מוחק ערך, לא שדה

מנקה את ערך השדה ברשומה הזו בלבד: השדה נשאר בסכימה, והרשומה נשארת. זו הדרך היחידה לרוקן שדה. "" ו‑null מייצרים ערך ריק שמתנהג אחרת ב‑$exists:

מה נשלח	$exists:true	$exists:false	שוויון ישיר
{"__op":"Delete"}	—	✔	—
null	✔	—	{"Field":null} ✔
""	—	—	{"Field":""} ✔

מחרוזת ריקה נעלמת משני צידי $exists. “בלי ערך” = {"Field":{"$in":[null,""]}}, תופס גם שדה חסר.

DELETE מחיקה

DELETE /parse/classes/{Table}/{objectId}

בלתי הפיך. מחזיר {}; שליפה אחריו מחזירה 404 עם {"code":101,"error":"Object not found."}.

מחיקה כמעט לא משאירה עקבות

שורת המחיקה ב‑_Timeline מכילה event, objectClass, objectIdValue, user וזמן בלבד, בלי הערכים שנמחקו ובלי מצביעים: המחיקה לא תופיע בציר הזמן של הכרטיס, והיומן לא ישמור מה נמחק. העדיפו שדה ביטול או ארכיון. יומנים וראיות.

מחיקה נחסמת כשמישהו מצביע על הרשומה

במערכת חדשה דלוק המתג Check dependencies before Delete operation (סביבת פיתוח ← Databases ← המערכת ← Settings), ו‑DELETE לרשומה שיש אליה Pointer מוחזר עם:

JSON

{ "code": 119,
  "error": "Pointer to Object xK9mP2qRsT exists in table Tasks in key AccountId. Delete is not allowed." }

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

דגלים להשתקת טריגרים ויומן השינויים

שני דגלים משתיקים אוטומציות ו‑_Timeline על כתיבה בודדת. הם חלים על כל כתיבה: POST, PUT, וכל פעולה בתוך batch. את שניהם שולחים בתוך אובייקט הגוף, לצד השדות:

הדגל	מה נחסם
dontRunSimblaTriggers	טריגרי data change על הכתיבה הזו: אפס הרצות במקום שרשרת האוטומציה המלאה
dontUpdateSimblaTimeline	שורות _Timeline על הכתיבה הזו
dontRunSimblaTriggersCreate	רק פעולות (actions) מסוג יצירת אובייקט בתוך הטריגרים שרצים. הטריגר עצמו רץ; פעולת היצירה שבו מדולגת
dontRunSimblaTriggersUpdate	רק פעולות מסוג עדכון אובייקט בתוך הטריגרים שרצים

JSON

{
  "Name": "new account name",
  "dontRunSimblaTriggers": true,
  "dontUpdateSimblaTimeline": true
}

רק באימות Master Key או API Key. הדגלים אינם שדות: השרת צורך אותם, הרשומה נשמרת בלעדיהם, ולא נוצרת עמודה בסכימה.

שימו לב להבדל בין שתי הרמות: dontRunSimblaTriggers משתיק את הטריגרים כולם, ואילו …Create / …Update מדלגים רק על פעולת יצירה/עדכון של אובייקט בתוך טריגר שרץ. על טריגר שכל הפעולות שלו הן מייל או התראה, שני הדגלים הממוקדים לא משנים דבר.

מקום השליחה קובע, וכישלון הוא שקט

בגוף האובייקט בלבד. אותו דגל ב‑query string, או ליד requests בבקשת batch, נבלע ללא שגיאה: הכתיבה מצליחה, מפעילה את הטריגרים ורושמת _Timeline כרגיל. אין בתשובה אישור שהדגל נקלט, ולכן אמתו מול _Timeline ו‑_syslogTriggers של הרשומה. ראו יומנים וראיות.

השתקה היא פער ביקורת מכוון

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

הזרימה הקנונית: איש קשר ואז רשומה מקושרת

חיפוש‑או‑יצירה של Accounts, ואז רשומה שמקושרת אליו.

Python

import json, requests

API = "https://api.mbapps.co.il/parse"
H = {"X-Parse-Application-Id": APP_ID,
     "X-Parse-API-Key": API_KEY,
     "Content-Type": "application/json"}

def find_or_create_account(phone: str, name: str) -> str:
    # 1) חיפוש לפי הטלפון — הפלטפורמה לא אוכפת ייחודיות, זה באחריותנו
    r = requests.get(f"{API}/classes/Accounts", headers=H,
                     params={"where": json.dumps({"PhoneNumber": phone}), "limit": 5},
                     timeout=30)
    r.raise_for_status()
    hits = r.json()["results"]
    if len(hits) > 1:
        print(f"אזהרה: {len(hits)} רשומות עם אותו טלפון — נבחרה הראשונה")
    if hits:
        return hits[0]["objectId"]

    # 2) יצירה
    r = requests.post(f"{API}/classes/Accounts", headers=H,
                      json={"Name": name, "PhoneNumber": phone, "IsAccount": False},
                      timeout=30)
    r.raise_for_status()
    return r.json()["objectId"]

def create_task(account_id: str, title: str, due_iso: str) -> str:
    body = {
        "Name": title,
        "Date": {"__type": "Date", "iso": due_iso},
        "AccountId": {"__type": "Pointer", "className": "Accounts", "objectId": account_id},
    }
    r = requests.post(f"{API}/classes/Tasks", headers=H, json=body, timeout=30)
    r.raise_for_status()
    return r.json()["objectId"]

acc = find_or_create_account("0501234567", "ישראל ישראלי")
create_task(acc, "התקשר ללקוח", "2026-01-15T10:30:00.000Z")

אותה תבנית יוצרת Activities (Name, StartTime, EndTime, AccountId) ו‑Sales (Name, SaleStatusId, Total, ClosingDate, AccountId). שמות השדות משתנים בין מערכות: שלפו סכימה.

אין אכיפת ייחודיות, וטלפונים ישראליים חיים בכמה פורמטים

אין אכיפת ייחודיות על PhoneNumber או Email: שתי רשומות עם אותו טלפון ואותו אימייל ייווצרו שתיהן. חיפוש לפני יצירה באחריותכם. באותה טבלה חיים 0501234567, 972501234567 ו‑+972-50-1234567; שאילתה על פורמט אחד תחמיץ את השאר (דפוס ה‑$or). getlead ו‑web2table מזהים כפילויות בצד השרת, על כל הווריאציות.

מזהה זר

בסנכרון ממערכת חיצונית כתבו את המזהה שלה ל‑ExternalId ביצירה; הזיהוי הופך חד‑משמעי:

Python

params = {"where": json.dumps({"ExternalId": "CRM-84213"}), "limit": 1}

טופס באתר: לא דרך העמוד הזה

הקריאות כאן דורשות מפתח, ומפתח בדפדפן דולף. לטפסים ציבוריים יש שכבה בלי סודות: web2* תחת /functions/{appId}/.

JavaScript

await fetch(`https://api.mbapps.co.il/functions/${APP_ID}/web2table`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-Parse-Application-Id': APP_ID },
  body: JSON.stringify({ table: 'Tasks', Name: 'התקשר ללקוח', phone: '0501234567' }),
});
// -> 200 {"success":true,"accountId":"…","Id":"…"}

getlead, לא “web2lead”

פונקציית לכידת הליד היא getlead. השם “web2lead” מחזיר 400 {"error":"User function not found"}. ראו getlead.

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

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

עוד

• אין הגבלת קצב מתועדת: אלפי קריאות רצופות, כולל batch של 1,000 פעולות, לא החזירו ולו 429 אחד, ואין כותרות מגבלה. “לא מתועד” אינו “לא קיים”: חלקו לקבוצות והוסיפו השהיה בטעינות גדולות. מגבלות.
• פעולות ברמת החשבון (חבילות, מושבים, הקמת מערכת חדשה) אינן ב‑API הזה.
• שינוי סכימה: PUT /parse/schemas/<Table> עם Master Key עובד ומוסיף שדה, אבל מדלג על שכבות המוצר (תווית עברית, הרשאות). לא ב‑REST גולמי: סכימות.

עמודים שלא במפה: שגיאות · יומנים וראיות · דוגמאות קוד בשפות נוספות