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

ה‑API בנוי מעל Parse Server. מי שמכיר Parse ירגיש בבית; מי שלא, העמוד הזה הוא נקודת הפתיחה, ומכאן מתפצלים העמודים הייעודיים.

מפת הנקודות

מה	הכתובת	העמוד
בסיס ה‑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 פתוח כברירת מחדל, כך ש‑fetch מהדפדפן עובד, כל עוד לא תשלחו סוד מהדפדפן.

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

1. שלפו סכימה — כי שם השדה שאתם זוכרים אולי לא קיים במערכת הזו.
2. עברו על סוגי הנתונים — כי 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 מתקבל כמות שהוא, בכל אורך ("abc", 45 תווים…); ערך שאינו ASCII מחזיר 500, ומזהה שכבר קיים — 400 עם code 137. עם Session Token השדה נדחה (code 105). שלחו objectId רק בהגירה מכוונת, ואז שמרו על 10 תווים ASCII — כלי ה‑MCP (Get-Data) דורשים בדיוק 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": "…" }.

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

במקום לקרוא־לשנות־לכתוב — שלחו אופרטור. גם בטוח יותר מול מרוץ בין תהליכים:

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" מוחק ערך, לא שדה

הוא מנקה את ערך השדה ברשומה הזו — לא את השדה מהסכימה (השדה נשאר ב‑/parse/schemas), ובוודאי לא את הרשומה. זו גם הדרך היחידה “לרוקן” שדה באמת. שליחת "" או 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." }

תכננו סדר מחיקה (קודם הילדים, אחר כך האב), ואל תניחו שמחיקה תמיד תצליח. אם המתג כובה בהגדרות המערכת — מצביעים כן נשארים תלויים באוויר.

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

זו התבנית שכמעט כל אינטגרציה מיישמת: חיפוש‑או‑יצירה של 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":"…"}

נתקלתם בשם “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 יושב לפני בדיקת ההרשאות. מה שכן קורה: הקריאה האנונימית נפתחת. ראו שגיאות.

מה עוד כדאי לדעת

• אין הגבלת קצב מתועדת ל‑api.mbapps.co.il. באלפי קריאות רצופות — כולל batch של 1,000 פעולות — לא חוזר ולו 429 אחד, ואין כותרות מגבלה בתשובות. “לא מתועד” עדיין אינו “לא קיים”: חלקו לקבוצות והוסיפו השהיה בטעינות גדולות. מגבלות ומכסות.
• פעולות ברמת החשבון (חבילות, מושבים, הקמת מערכת חדשה) אינן חלק מ‑API זה.
• שינוי סכימה — PUT /parse/schemas/<Table> עם Master Key אמנם עובד (הוא מוסיף שדה), אבל מדלג על שכבות המוצר (תווית עברית, הרשאות). אל תעשו זאת ב‑REST גולמי — סכימות.
• CORS — ה‑preflight מחזיר את ה‑Origin ששלחתם ב‑Access-Control-Allow-Origin (לא *), עם GET,PUT,POST,DELETE,OPTIONS וכל כותרות ה‑X-Parse-*.

המשך מכאן

• שאילתות — סינון, מיון, עימוד
• batch — כמה פעולות בבקשה אחת
• אגרגציות — סכומים במקום שורות
• סכימות · משתמשים · קבצים · פונקציות צד שרת
• שגיאות ופתרון תקלות · יומנים וראיות · מגבלות
• דוגמאות קוד בשפות נוספות