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

# התחלה מהירה עם ה-API

## יצירת מפתח API

ב-Tamloot, פתחו **הגדרות ← API**. צרו מפתח והעתיקו אותו מיד: הסוד המלא מוצג פעם אחת בלבד. הגישה ל-API זמינה לחשבונות שהופעלו עבורם ההרשאות. אם אזור ה-API אינו מוצג, [פנו לתמיכה](https://tamloot.cc/he/support).

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

```bash
export TAMLOOT_API_KEY="tml_live_replace_with_your_key"
```

## שליחת בקשה

חפשו אדם לפי שם, כתובת דוא״ל או מספר טלפון. מונח החיפוש חייב לכלול 2–100 תווים.

```bash
curl --get "https://api.tamloot.cc/v1/contacts" \
  --header "Authorization: Bearer $TAMLOOT_API_KEY" \
  --data-urlencode "query=maya"
```

תשובת ה-JSON כוללת את אנשי הקשר התואמים בשדה `data`. רשימה ריקה משמעה שלא נמצאו התאמות, ולא שיש שגיאה באימות.

## שימוש בתוצאה

קחו את ה-`id` של איש קשר והעבירו אותו כ-`contact_id` כדי [לעיין בפגישות](/he/docs/developers/api-reference/search-sessions). המשיכו לפי `pagination.next_offset` כל עוד `pagination.has_more` הוא `true`.

ה-API קורא רק מידע שבעל המפתח מורשה לראות. הוא אינו מאפשר ליצור, לשנות או למחוק רשומות. [עיינו בכל נקודות הקצה](/he/docs/developers/api-reference).

## טיפול בשגיאות

- `401`: בדקו את כותרת ה-Bearer והאם המפתח בוטל או הוחלף.
- `404`: הרשומה אינה קיימת או אינה גלויה לחשבון הזה.
- `422`: תקנו את הפרמטרים לפי מפרט נקודת הקצה.
- `429`: המתינו את מספר השניות שב-`Retry-After`, ואז נסו שוב.

אפשר להחליף או לבטל מפתחות ב-**הגדרות ← API**. [סקירת ה-API](/he/docs/developers/api) כוללת מגבלות קצב וניהול גרסאות. לחיבור כלי AI, עברו ל[הגדרת MCP](/he/docs/developers/mcp-server).

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

- [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)