טפסים מהאתר — מאיזו נקודת קצה מתחילים

שתי נקודות קצה לטפסים מדף חיצוני. רצות בצד השרת, בלי Master Key ובלי SDK, מהדפדפן של גולש אנונימי.

צריך שתיפתח רשומה אחרי השליחה, ולא רק כרטיס איש קשר: web2table.

curl -X POST "https://api.mbapps.co.il/functions/{appId}/getlead" \
  -H "Content-Type: application/json" \
  -H "X-Parse-Application-Id: {appId}" \
  -d '{ "Name": "ישראל ישראלי", "PhoneNumber": "0501234567" }'

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

import requests

res = requests.post(
    f"https://api.mbapps.co.il/functions/{appId}/getlead",
    headers={
        "Content-Type": "application/json",
        "X-Parse-Application-Id": appId,
    },
    json={
        "Name": "ישראל ישראלי",
        "PhoneNumber": "0501234567",
    },
)

<?php
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.mbapps.co.il/functions/{$appId}/getlead",
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "X-Parse-Application-Id: {$appId}",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "Name" => "ישראל ישראלי",
        "PhoneNumber" => "0501234567",
    ], JSON_UNESCAPED_UNICODE),
]);
$response = curl_exec($ch);
curl_close($ch);

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

שלושת השערים, כולם בצד השרת:

1. דגל ה‑Config שמפעיל את נקודת הקצה: דגלי Config.
2. ולידציה של השדות מול הסכימה, ו‑ValidatePhoneOrEmail אם הלקוח הדליק אותו.
3. שער ה‑CAPTCHA של Parse שחוסם כל יצירה אנונימית אחרת שאינה נושאת טוקן reCAPTCHA של הפלטפורמה: מודל האבטחה.

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

// getlead — שטוח, בשמות הסכימה
{ "Name": "ישראל ישראלי", "PhoneNumber": "0501234567", "City": "תל אביב" }

// web2table — אותו איש קשר, שמות אחרים לגמרי
{ "table": "Sales", "phone": "0501234567",
  "account_Name": "ישראל ישראלי", "account_City": "תל אביב" }

1. הדליקו את הדגל. נקודת הקצה חסומה עד להפעלה בטבלת Config, ו‑400 {"error":"…​ is Disabled"} בקריאה הראשונה זה כמעט תמיד זה.
2. שלפו את הסכימה של Accounts, ושל טבלת היעד ב‑web2table, ובנו מפת שדות.
3. כתבו את הטופס לפי הדיאלקט: getlead או web2table.
4. בררו מה יקרה לכפילויות.
5. הטמיעו, ואז מודל האבטחה לפני שמישהו “מתקן” הרשאות.

דילוג על צעד 1 או 2 הוא הסיבה לרוב התקלות.

• מודל הנתונים ומוסכמות — למה Accounts מחזיקה גם לידים וגם לקוחות
• דוגמאות קוד — PHP · Python · Node.js · C# · JavaScript
• שגיאות ופתרון תקלות — קודי השגיאה של כל השכבות