# API למפתחים: איטום 148 | איטום 148

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

מקור: https://etom148.com/developers


![](https://etom148.com/_next/image?url=%2Fimages%2Froof-white-membrane.jpg&w=1920&q=60)

1. [ראשי](https://etom148.com/)/
2. API למפתחים

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

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

[ קבלו הצעת מחיר בוואטסאפ](https://wa.me/972723317667?text=%D7%94%D7%99%D7%99%2C%20%D7%94%D7%92%D7%A2%D7%AA%D7%99%20%D7%9E%D7%94%D7%A2%D7%9E%D7%95%D7%93%20API%20%D7%95-MCP%20%D7%9C%D7%9E%D7%A4%D7%AA%D7%97%D7%99%D7%9D%20%D7%95%D7%9C%D7%A1%D7%95%D7%9B%D7%A0%D7%99%20AI%20%D7%95%D7%90%D7%A9%D7%9E%D7%97%20%D7%9C%D7%A7%D7%91%D7%9C%20%D7%94%D7%A6%D7%A2%D7%AA%20%D7%9E%D7%97%D7%99%D7%A8)[ או התקשרו: 072-3317667](tel:+972723317667)

- עסק שומר שבתעובדים כל השבוע חוץ משבת קודש
- אנשי מקצוע באיטוםשירות מהיר ואיכותי בתחום האיטום
- 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](https://etom148.com/auth.md).

## קבצי תיאור

- [OpenAPI 3.1](https://etom148.com/openapi.json)
- [API catalog](https://etom148.com/.well-known/api-catalog)
- [MCP server card](https://etom148.com/.well-known/mcp/server-card.json)
- [A2A agent card](https://etom148.com/.well-known/agent-card.json)
- [Agent skills](https://etom148.com/.well-known/agent-skills/index.json)
- [auth.md](https://etom148.com/auth.md)
- [OAuth metadata](https://etom148.com/.well-known/oauth-authorization-server)
- [llms.txt](https://etom148.com/llms.txt)

שימוש בטופס הפנייה (`/api/lead`) מותר רק בהסכמה מפורשת של המשתמש. ראו [מדיניות פרטיות](https://etom148.com/privacy) ו-[תנאי שימוש](https://etom148.com/terms).

## יצירת קשר

- וואטסאפ (מומלץ): https://wa.me/972723317667?text=%D7%94%D7%99%D7%99%2C%20%D7%90%D7%A0%D7%99%20%D7%A8%D7%95%D7%A6%D7%94%20%D7%9C%D7%A9%D7%9E%D7%95%D7%A2%20%D7%A2%D7%9C%20%D7%90%D7%99%D7%98%D7%95%D7%9D%20%D7%92%D7%92%D7%95%D7%AA
- טלפון: 072-3317667 (tel:+972723317667)
- טופס פנייה: https://etom148.com/contact
