API ו-MCP למפתחים ולסוכני AI
תיעוד ה-API הציבורי של איטום 148: חיפוש מדריכים, נושאים, אזורי שירות ופרטי קשר ב-JSON, שרת MCP, סוכן A2A ומגבלות שימוש.
- עסק שומר שבתעובדים כל השבוע חוץ משבת קודש
- אנשי מקצוע באיטוםשירות מהיר ואיכותי בתחום האיטום
- 68 ערים ברחבי הארץאיטום גגות בבית שמש, ירושלים, אשדוד ועוד
- פתוחים לפניותא׳–ה׳ 09:00–19:00, ו׳ 09:00–11:00
- בבעלות איש מילואיםוגם העובדים עושים מילואים
כל התוכן באתר זמין גם למכונות: ממשק JSON לקריאה בלבד, שרת MCP וסוכן A2A. אין צורך בהרשמה או במפתח. הממשק מחזיר מידע מהמדריכים ומפרטי הקשר בלבד, ושום קריאה לא יוצרת קשר עם אף אחד בשם המשתמש. גרסה נוכחית: 1.0.0.
נקודות קצה
| Method | Path | תיאור |
|---|---|---|
| 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) מותר רק בהסכמה מפורשת של המשתמש. ראו מדיניות פרטיות ו-תנאי שימוש.
