דלג לתוכן

API ו-MCP למפתחים ולסוכני AI

תיעוד ה-API הציבורי של איטום 148: חיפוש מדריכים, נושאים, אזורי שירות ופרטי קשר ב-JSON, שרת MCP, סוכן A2A ומגבלות שימוש.

  • עסק שומר שבתעובדים כל השבוע חוץ משבת קודש
  • אנשי מקצוע באיטוםשירות מהיר ואיכותי בתחום האיטום
  • 68 ערים ברחבי הארץאיטום גגות בבית שמש, ירושלים, אשדוד ועוד
  • פתוחים לפניותא׳–ה׳ 09:00–19:00, ו׳ 09:00–11:00
  • בבעלות איש מילואיםוגם העובדים עושים מילואים

כל התוכן באתר זמין גם למכונות: ממשק JSON לקריאה בלבד, שרת MCP וסוכן A2A. אין צורך בהרשמה או במפתח. הממשק מחזיר מידע מהמדריכים ומפרטי הקשר בלבד, ושום קריאה לא יוצרת קשר עם אף אחד בשם המשתמש. גרסה נוכחית: 1.0.0.

נקודות קצה

MethodPathתיאור
GET/api/v1/articles?q=&topic=&limit=חיפוש במדריכים (limit בין 1 ל-50)
GET/api/v1/articles/{slug}פרטי מדריך אחד
GET/api/v1/topicsרשימת נושאי המדריכים
GET/api/v1/areas?city=אזורי שירות
GET/api/v1/contactטלפון, וואטסאפ ושעות פעילות
POST/api/leadשליחת פנייה, רק בהסכמת המשתמש ועם פרטיו האמיתיים
POST/mcpשרת MCP (Streamable HTTP, JSON-RPC 2.0), קריאה בלבד
POST/a2aסוכן A2A (JSON-RPC, message/send)

גרסאות

הגרסה הראשית מופיעה בנתיב (/api/v1), וכל תשובה כוללת כותרת x-api-version. שינוי שובר ייצא כ-/api/v2, ו-v1 יישאר זמין לפחות שישה חודשים אחרי הודעה בעמוד הזה ובקובץ ה-OpenAPI.

שגיאות

כל שגיאה מוחזרת כ-JSON באותו מבנה, עם קוד HTTP מתאים וקוד מכונה יציב:

{
  "error": {
    "code": "invalid_limit",
    "message": "limit must be an integer 1-50.",
    "status": 400,
    "docs": "https://etom148.com/developers"
  }
}

מגבלת קצב

60 בקשות לדקה לכל כתובת IP. כל תשובה כוללת RateLimit-Limit, RateLimit-Remaining ו-RateLimit-Reset. מעבר למגבלה מחזיר 429 עם Retry-After.

הרשאות

הממשק ציבורי. מי שהכלי שלו דורש OAuth יכול לקבל טוקן אנונימי ב-client_credentials דרך /oauth/token; הטוקן מתקבל אבל לא נדרש. הפרטים ב-auth.md.

קבצי תיאור

שימוש בטופס הפנייה (/api/lead) מותר רק בהסכמה מפורשת של המשתמש. ראו מדיניות פרטיות ו-תנאי שימוש.