---
title: "Tamloot — API ציבורי"
description: "ה-API הציבורי של Tamloot מאפשר לכלים שלכם לקרוא אנשי קשר, פגישות, תמלולים וסיכומים מהחשבון שלכם."
canonical: "https://tamloot.cc/he/docs/developers/api"
last-updated: "2026-10-18"
---

# API ציבורי

ה-API הציבורי של Tamloot מאפשר לכלים שלכם לקרוא אנשי קשר, פגישות, תמלולים וסיכומים מהחשבון שלכם.

## התחילו כאן

1. ב-Tamloot, פתחו **הגדרות ← API**.
2. צרו מפתח API והעתיקו אותו מיד. המפתח המלא מוצג פעם אחת בלבד.
3. שלחו אותו כ-Bearer token בכל בקשה לנתונים.

```bash
curl "https://api.tamloot.cc/v1/contacts?query=maya" \
  -H "Authorization: Bearer tml_live_your_key"
```

## מקורות למפתחים

- כתובת בסיס: `https://api.tamloot.cc/v1`
- תיאור OpenAPI: [openapi.json](https://tamloot.cc/openapi.json)
- קטלוג API: [/.well-known/api-catalog](https://tamloot.cc/.well-known/api-catalog)
- אינדקס למפתחים: [משאבי הפיתוח של Tamloot](https://tamloot.cc/he/developers)

## מגבלות קצב

ה-API מאפשר **10 בקשות בשנייה** (עד 20 בפרץ קצר). כל תגובה כוללת את מדיניות הקצב כדי שתוכלו לתזמן בקשות מראש:

| כותרת | משמעות | מתי נשלחת |
| --- | --- | --- |
| `RateLimit-Limit` | מספר הבקשות המותר בחלון של שנייה | בכל תגובה |
| `RateLimit-Policy` | המדיניות, בפורמט `<limit>;w=<window seconds>` | בכל תגובה |
| `Retry-After` | מספר השניות להמתנה לפני ניסיון נוסף | בתגובת `429` בלבד |

בקשה שחורגת מהמגבלה מקבלת `429 Too Many Requests` ו-`Retry-After`. המתינו את מספר השניות שצוין ונסו שוב.

אין כותרות `RateLimit-Remaining` או `RateLimit-Reset`. המגבלה נאכפת בקצה הרשת, לפני שרת האפליקציה, ולכן שרת יחיד אינו רואה את סך הבקשות שלכם. תזמנו בקשות לפי `RateLimit-Policy`, והתייחסו ל-`429` כאיתות המחייב להמתין.

## גרסאות והוצאה משימוש

גרסת ה-API מופיעה בנתיב (`/v1`). בתוך אותה גרסה מתווספים רק נתיבים, פרמטרים אופציונליים ושדות תגובה. כלים שמשתמשים ב-API צריכים להתעלם משדות שאינם מכירים.

שינויים ששוברים תאימות יוצאים רק בגרסה חדשה. גרסה שמוצאת משימוש ממשיכה לפעול **לפחות 6 חודשים** לאחר ההודעה בעמוד הזה. בתקופה הזו כל תגובה כוללת כותרת `Deprecation` לפי [RFC 9745](https://www.rfc-editor.org/rfc/rfc9745) וכותרת `Sunset` עם תאריך הסגירה לפי [RFC 8594](https://www.rfc-editor.org/rfc/rfc8594).

## נתיבים

| שיטה | נתיב | מטרה |
| --- | --- | --- |
| GET | `/contacts?query=` | חיפוש אנשי קשר |
| GET | `/contacts/{contact_id}` | קריאת איש קשר וההקשר שלו |
| GET | `/sessions` | עיון בפגישות או חיפוש |
| GET | `/sessions/{session_id}` | קריאת פגישה וסיכומים |
| GET | `/sessions/{session_id}/transcript` | קריאת טקסט התמלול |
| GET | `/notes?query=` | חיפוש סיכומים |

ה-API מיועד לקריאה בלבד. אפשר להחליף או לבטל מפתח בכל עת תחת **הגדרות ← API**.

## קישורים נוספים

- [Tamloot](https://tamloot.cc/he)
- [כל המדריכים](https://tamloot.cc/he/docs)
- [llms.txt](https://tamloot.cc/docs/llms.txt)
- [Sitemap](https://tamloot.cc/sitemaps/sitemap.xml)