תיעוד API

בנה אינטגרציות מותאמות עם ה-API של Asyntai

נדרשת תוכנית בתשלום: גישה ל-API זמינה בתוכניות Starter, Standard ו-Pro. צפה במחירים

סקירה כללית

The Asyntai API allows you to integrate AI-powered customer support into any application. Send messages and receive intelligent responses grounded in your website content and knowledge base.

אימות

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

כלול את מפתח ה-API שלך בבקשות באמצעות אחת מהשיטות הבאות:

כותרת Authorization (מומלץ): Authorization: Bearer YOUR_API_KEY
כותרת X-API-Key: X-API-Key: YOUR_API_KEY

שמור על סודיות מפתח ה-API שלך. כל מי שיש לו את המפתח שלך יכול לגשת לחשבונך דרך ה-API. לעולם אל תחשוף אותו בקוד צד לקוח.

כתובת בסיס

https://asyntai.com/api/v1/

נקודות קצה

POST /chat/

שלח הודעה וקבל תשובה שנוצרה על ידי AI.

גוף הבקשה

{
  "message": "What are your business hours?",
  "session_id": "user_123",      // optional
  "website_id": 1                 // optional
}

פרמטר	סוג	נדרש	תיאור
`message`	string	כן	הודעת המשתמש לשליחה ל-AI
`session_id`	string	לא	מזהה ייחודי לשיחה. השתמש באותו session_id כדי לשמור על היסטוריית השיחה.
`website_id`	integer	לא	מזהה אתר ספציפי. אם לא סופק, משתמש באתר הראשי שלך.

תגובה

{
  "success": true,
  "response": "Our business hours are Monday-Friday, 9 AM to 5 PM EST.",
  "session_id": "user_123"
}

דוגמה (cURL)

curl -X POST https://asyntai.com/api/v1/chat/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "What are your business hours?", "session_id": "user_123"}'

דוגמה (Python)

import requests

response = requests.post(
    "https://asyntai.com/api/v1/chat/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "message": "What are your business hours?",
        "session_id": "user_123"
    }
)

data = response.json()
print(data["response"])

דוגמה (JavaScript)

const response = await fetch("https://asyntai.com/api/v1/chat/", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    message: "What are your business hours?",
    session_id: "user_123"
  })
});

const data = await response.json();
console.log(data.response);

GET /websites/

הצג את כל האתרים המשויכים לחשבון שלך.

תגובה

{
  "success": true,
  "websites": [
    {
      "id": 1,
      "name": "My Website",
      "domain": "example.com",
      "is_primary": true
    }
  ]
}

דוגמה (cURL)

curl https://asyntai.com/api/v1/websites/ \
  -H "Authorization: Bearer YOUR_API_KEY"

POST /websites/

Create a new AI agent. This does the same thing as adding a website in your dashboard: it makes the agent, reads your site, and writes the first draft of the AI instructions.

Use this to set up customers from your own software. You get back the widget ID and the code to put on the website.

גוף הבקשה

שדה	סוג	תיאור
`domain`	string	Required. The website address, for example example.com
`name`	string	Optional. A display name for the agent. Useful when one website has several agents.
`crawl`	boolean	Optional, true by default. Set it to false to create the agent without reading the website. Nothing is crawled and no instructions are written.
`force`	boolean	Optional, false by default. Set it to true to add a website you already have. The copy is stored with a number after it.

תגובה

{
  "success": true,
  "website": {
    "id": 42,
    "domain": "example.com",
    "name": "Support agent",
    "widget_id": "asyntai_ab12cd34ef56",
    "is_primary": true,
    "crawl_started": true,
    "instructions_status": "generating",
    "job_id": "8f2c1e90-..."
  },
  "embed_code": "<script>...</script>"
}

דוגמה (cURL)

curl -X POST https://asyntai.com/api/v1/websites/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com", "name": "Support agent"}'

Reading a website takes a few minutes, so this call answers straight away. Check when the agent is ready with the next endpoint.

Errors

Code	Meaning
`403`	You have reached the number of websites your plan allows. The answer tells you the limit.
`409`	Your account already has this website. Send force as true to add it again.

GET /websites/{id}/

Get one website and see whether it is ready. Use this after you create an agent, to wait until the website has been read and the AI instructions are written.

תגובה

{
  "success": true,
  "website": {
    "id": 42,
    "domain": "example.com",
    "name": "Support agent",
    "widget_id": "asyntai_ab12cd34ef56",
    "is_primary": true,
    "created_at": "2026-08-11T09:12:00+00:00",
    "ready": true,
    "instructions": {
      "status": "completed",
      "has_instructions": true,
      "characters": 3421
    },
    "crawl": {
      "job_id": "8f2c1e90-...",
      "status": "completed",
      "pages_crawled": 47,
      "pages_found": 50,
      "max_pages": 50,
      "completed_at": "2026-08-11T09:15:31+00:00",
      "error": ""
    },
    "knowledge_items": 47
  },
  "embed_code": "<script>...</script>"
}

The ready field is true when nothing is still running. A crawl that failed also counts as ready, because it has finished. Look at the crawl status to see what happened.

דוגמה (cURL)

curl https://asyntai.com/api/v1/websites/42/ \
  -H "Authorization: Bearer YOUR_API_KEY"

GET PATCH /websites/{id}/settings/

Read or change the chat widget settings for one website. These are the same settings you see on the Customize page: colours, the name of the assistant, the first message, lead capture, and everything else.

Reading the settings

A GET request returns every setting with its current value, plus a locked list. Locked shows the settings your plan cannot change, and which plans they need.

{
  "success": true,
  "settings": {
    "ai_support_name": "AI Assistant",
    "widget_color": "#6366f1",
    "initial_message": "Hi, how can I help you?",
    "hide_branding": false,
    "...": "..."
  },
  "locked": {
    "hide_branding": ["pro", "enterprise"],
    "widget_style": ["pro", "enterprise"]
  }
}

Changing the settings

A PATCH request changes only the settings you send. Everything you leave out stays as it is.

curl -X PATCH https://asyntai.com/api/v1/websites/42/settings/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ai_support_name": "Ava", "widget_color": "#0f172a", "use_emoji": true}'

{
  "success": true,
  "updated": ["ai_support_name", "use_emoji", "widget_color"],
  "settings": { "...": "..." },
  "locked": { "...": "..." }
}

Plans

Each setting needs its own plan, the same as in the dashboard. For example, hiding the Asyntai branding needs the Pro plan, and voice input needs Standard.

Plan needed	הגדרות	Examples
Any paid plan	25	`widget_color`, `ai_support_name`, `initial_message`
Starter ומעלה	22	`profile_picture`, `conversation_starters_enabled`
Standard ומעלה	25	`speech_to_text_enabled`, `image_vision_enabled`, `escalation_enabled`
Pro	6	`hide_branding`, `widget_style`

If you send a setting your plan does not allow, the whole request is refused with code 403 and nothing is saved. The same happens if any value is wrong, for example a colour that is not a hex code. Your settings never end up half changed.

GET PUT /websites/{id}/instructions/

Read or replace the AI instructions for one website. These are the rules that tell the assistant who it is, what it may say, and what it must not say. They are the same instructions you edit in the dashboard.

Reading

{
  "success": true,
  "instructions": "You are the support agent for Acme Tools...",
  "characters": 1979,
  "version": 7,
  "mode": "instructions",
  "ask_questions": true,
  "generation_status": "completed",
  "being_edited_by": null
}

Replacing

A PUT request replaces the whole text, the same as saving in the dashboard. There is no append mode. To add a paragraph, read the instructions, add your text, then write it back.

curl -X PUT https://asyntai.com/api/v1/websites/42/instructions/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instructions": "You are the support agent for Acme Tools...", "version": 7}'

גוף הבקשה

שדה	סוג	תיאור
`instructions`	string	Required. The complete new text. It replaces everything that was there.
`version`	number	Optional but recommended. The version you read. If somebody changed the instructions since then, your write is refused instead of overwriting their work.
`mode`	string	Optional. Either instructions or general.
`ask_questions`	boolean	Optional. Whether the assistant asks a follow-up question at the end of its answers.
`force`	boolean	Optional, false by default. Needed only when your new text is less than half the length of the current text.

How your instructions are protected

Instructions can take hours to write, so a write can be refused to protect them:

Code	Meaning
`400`	Your new text is less than half the length of the current text. This catches a script that sends empty or cut-off text over instructions somebody spent hours on. Send force as true if you meant it.
`409`	The instructions changed after you read them. Read them again, apply your change, then write.
`423`	Somebody is editing the instructions in the dashboard right now. The answer tells you who. Try again in a couple of minutes.

Every change also saves a copy of the previous text, so an earlier version can always be restored from the dashboard.

GET /conversations/

אחזר היסטוריית שיחות עבור מפגש ספציפי.

פרמטרי שאילתה

פרמטר	סוג	נדרש	תיאור
`session_id`	string	כן	מזהה המפגש לאחזור היסטוריה
`limit`	integer	לא	מספר הודעות מקסימלי להחזרה (ברירת מחדל: 50, מקסימום: 100)

תגובה

{
  "success": true,
  "session_id": "user_123",
  "messages": [
    {
      "role": "user",
      "content": "What are your business hours?",
      "timestamp": "2024-01-15T10:30:00Z"
    },
    {
      "role": "assistant",
      "content": "Our business hours are Monday-Friday, 9 AM to 5 PM EST.",
      "timestamp": "2024-01-15T10:30:01Z",
      "sender_type": "ai",
      "agent_name": null,
      "response_time_ms": 1840.5
    }
  ]
}

שאלה והתשובה שלה נשמרות ברשומה אחת, ולכן שתיהן נושאות את אותו timestamp. אל תחסרו את האחת מהשנייה כדי למדוד את מהירות המענה, כי התוצאה תמיד אפס. השתמשו ב-response_time_ms, שהוא הזמן האמיתי שלקח למענה, במילישניות.

sender_type הוא ai כאשר הצ'אטבוט ענה, ו-human כאשר אחד הנציגים שלכם השתלט על הצ'אט. agent_name מכיל את שם התצוגה של אותו נציג.

דוגמה (cURL)

curl "https://asyntai.com/api/v1/conversations/?session_id=user_123&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /sessions/

הצג את מפגשי הצ'אט האחרונים שלך. השתמש בזה כדי לגלות מזהי מפגשים, שתוכל להעביר ל-/conversations/ כדי לאחזר את היסטוריית ההודעות המלאה.

פרמטרי שאילתה

פרמטר	סוג	נדרש	תיאור
`limit`	integer	לא	מספר מפגשים אחרונים להחזרה (ברירת מחדל: 20, מקסימום: 100)
`website_id`	string	לא	סנן מפגשים לפי מזהה אתר ספציפי
`source`	string	לא	סנן לפי מקור הפגישה: `widget`, `api`, `whatsapp`, `instagram`, `messenger`, `gorgias`, `freshchat`, `zapier`

תגובה

{
  "success": true,
  "sessions": [
    {
      "session_id": "session_abc123def",
      "source": "widget",
      "message_count": 5,
      "first_message": "What are your business hours?",
      "first_message_at": "2024-01-15T10:30:00Z",
      "last_message_at": "2024-01-15T10:35:00Z",
      "first_response_time_ms": 1840.5,
      "first_human_response_at": null,
      "started_at": "2024-01-15T10:29:58Z",
      "ended_at": "2024-01-15T10:41:12Z",
      "taken_over_at": null,
      "website_domain": "example.com"
    }
  ]
}

שדות חותמת זמן לדיווח

שדה	תיאור
`started_at`	מתי המבקר פתח את הצ'אט. זמין רק להפעלות של הווידג'ט, כי הפעלות שנוצרות דרך ה-API לעולם אינן פותחות ווידג'ט.
`first_message_at`	מתי נשמרה ההודעה הראשונה בשיחה.
`first_response_time_ms`	כמה זמן לקחה התשובה הראשונה, במילישניות. השתמשו בזה עבור זמן מענה ראשון.
`first_human_response_at`	מתי אחד הנציגים שלכם שלח את התשובה הראשונה. הערך הוא `null` כאשר הצ'אטבוט טיפל בכל השיחה.
`taken_over_at`	מתי נציג השתלט על הצ'אט מהצ'אטבוט.
`last_message_at`	מתי נשמרה ההודעה האחרונה בשיחה.
`ended_at`	מתי המבקר עזב את הצ'אט. לצ'אט אין מצב פתור או סגור, כי מבקר תמיד יכול לחזור ולשאול שאלה נוספת.

כל חותמות הזמן הן ב-UTC ומשתמשות בתבנית ISO 8601. אי אפשר לשנות את אזור הזמן. המירו את הערכים בכלי הדיווח שלכם.

דוגמה (cURL)

curl "https://asyntai.com/api/v1/sessions/?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /leads/

אחזור לידים שנאספו — כתובות דוא"ל ומספרי טלפון שהוגשו על ידי מבקרים במהלך שיחות צ'אט.

פרמטרי שאילתה

פרמטר	סוג	נדרש	תיאור
`limit`	integer	לא	מספר הלידים להחזרה (ברירת מחדל: 50, מקסימום: 100)
`website_id`	string	לא	סנן לידים לפי מזהה אתר ספציפי

תגובה

{
  "success": true,
  "leads": [
    {
      "session_id": "session_abc123def",
      "email": "[email protected]",
      "phone": "+1234567890",
      "page_url": "https://example.com/pricing",
      "started_at": "2024-01-15T10:30:00Z"
    }
  ]
}

שדה	סוג	תיאור
`session_id`	string	מזהה שיחת הצ'אט. העבר אותו ל-`/conversations/` כדי לראות את היסטוריית הצ'אט המלאה.
`email`	מחרוזת או null	כתובת דוא"ל שסופקה על ידי המבקר, או null אם לא נאספה
`phone`	מחרוזת או null	מספר טלפון שסופק על ידי המבקר, או null אם לא נאסף
`page_url`	מחרוזת או null	כתובת ה-URL של הדף שבו המבקר שוחח
`started_at`	string	חותמת זמן ISO 8601 של מועד תחילת שיחת הצ'אט

דוגמה (cURL)

curl "https://asyntai.com/api/v1/leads/?limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

דוגמה (Python)

import requests

response = requests.get(
    "https://asyntai.com/api/v1/leads/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"limit": 20}
)

leads = response.json()["leads"]
for lead in leads:
    print(f"{lead['email'] or ''} | {lead['phone'] or ''}")

GET /account/

קבל את פרטי החשבון וסטטיסטיקות השימוש שלך.

תגובה

{
  "success": true,
  "account": {
    "email": "[email protected]",
    "plan": "starter",
    "messages_used": 150,
    "messages_limit": 2500
  }
}

דוגמה (cURL)

curl https://asyntai.com/api/v1/account/ \
  -H "Authorization: Bearer YOUR_API_KEY"

מספר אתרים? נקודות הקצה של מאגר הידע מוגדרות כברירת מחדל לאתר הראשי שלך. אם יש לך מספר אתרים, העבר website_id כדי לפנות לאתר ספציפי. תוכל למצוא את מזהי האתרים שלך באמצעות GET /websites/.

מגבלות העלאה יומיות: העלאות למאגר הידע (טקסט, URL, גיליון אלקטרוני) כפופות למגבלת תווים יומית על בסיס התוכנית שלך. זה חל על סך התוכן שהועלה בכל נקודות הקצה של מאגר הידע ביום.

תוכנית	תווים/יום
Starter	300,000
Standard	1,500,000
Pro	6,000,000

GET /knowledge/

הצג את רשומות מאגר הידע שלך. אלו מקורות התוכן שצ'אטבוט ה-AI שלך משתמש בהם כדי לענות על שאלות.

פרמטרי שאילתה

פרמטר	סוג	נדרש	תיאור
`limit`	integer	לא	מספר רשומות להחזרה (ברירת מחדל: 50, מקסימום: 100)
`website_id`	string	לא	סנן לפי מזהה אתר (ברירת מחדל: האתר הראשי שלך)

תגובה

{
  "success": true,
  "entries": [
    {
      "id": "abc-123-def",
      "type": "text",
      "title": "Business Hours",
      "description": "Manual text content (150 words)",
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "ghi-456-jkl",
      "type": "url",
      "title": "About Us - Example",
      "description": "Content from https://example.com/about",
      "created_at": "2024-01-14T09:00:00Z"
    }
  ]
}

דוגמה (cURL)

curl "https://asyntai.com/api/v1/knowledge/?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST /knowledge/text/

הוסף תוכן טקסט מותאם למאגר הידע שלך. ה-AI ישתמש בזה כדי לענות על שאלות מבקרים.

גוף הבקשה

{
  "title": "Return Policy",
  "content": "We offer a 30-day return policy on all items. Items must be unused and in original packaging. Refunds are processed within 5-7 business days.",
  "website_id": "123"
}

פרמטר	סוג	נדרש	תיאור
`title`	string	כן	כותרת לרשומת ידע זו
`content`	string	כן	תוכן הטקסט (מינימום 10 תווים)
`website_id`	string	לא	אתר יעד (ברירת מחדל: האתר הראשי שלך)

תגובה

{
  "success": true,
  "id": "abc-123-def",
  "title": "Return Policy",
  "chunks_created": 1
}

דוגמה (cURL)

curl -X POST "https://asyntai.com/api/v1/knowledge/text/" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Return Policy", "content": "We offer a 30-day return policy..."}'

POST /knowledge/url/

הוסף דף אינטרנט למאגר הידע שלך. התוכן ייאסף ויחולץ באופן אוטומטי.

גוף הבקשה

{
  "url": "https://example.com/faq",
  "website_id": "123"
}

פרמטר	סוג	נדרש	תיאור
`url`	string	כן	כתובת ה-URL לאיסוף תוכן ממנה
`website_id`	string	לא	אתר יעד (ברירת מחדל: האתר הראשי שלך)

תגובה

{
  "success": true,
  "id": "abc-123-def",
  "title": "FAQ - Example",
  "url": "https://example.com/faq",
  "chunks_created": 5
}

דוגמה (cURL)

curl -X POST "https://asyntai.com/api/v1/knowledge/url/" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/faq"}'

POST /knowledge/spreadsheet/

העלה גיליון CSV או Excel (.xlsx) למאגר הידע שלך. כל שורה הופכת לרשומת ידע נפרדת, אידיאלי לקטלוגי מוצרים, רשימות שאלות נפוצות, טבלאות מחירים וספריות.

בקשה

שלח כ-multipart/form-data (העלאת קובץ), לא JSON.

פרמטר	סוג	נדרש	תיאור
`file`	file	כן	קובץ .csv או .xlsx. השורה הראשונה חייבת להיות כותרות עמודות. מקסימום שורות להעלאה: Starter 500, Standard 2,000, Pro 10,000. שורות עודפות נחתכות.
`website_id`	string	לא	אתר יעד (ברירת מחדל: האתר הראשי שלך)

תגובה

{
  "success": true,
  "id": "abc-123-def",
  "title": "products.csv",
  "rows_processed": 15,
  "chunks_created": 15
}

דוגמה (cURL)

curl -X POST "https://asyntai.com/api/v1/knowledge/spreadsheet/" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]"

GET /knowledge/{id}/

קרא רשומה אחת ממאגר הידע, כולל הטקסט השמור עבורה. הערך id מגיע מהתשובה של GET /knowledge/.

התוכן מוחזר עבור הרשומות שהוספת בעצמך: טקסט, קבצים, גיליונות, כתובות URL בודדות וסרטונים. סריקת אתר מופיעה ברשימה אך העמודים שלה אינם מוחזרים, מכיוון שהמקור הוא האתר הציבורי שלך. במקרה כזה content הוא null והשדה reason מסביר מדוע.

תגובה

{
  "success": true,
  "id": "abc-123-def",
  "type": "text",
  "title": "Business Hours",
  "description": "Manual text content (150 words)",
  "created_at": "2024-01-15T10:30:00Z",
  "chunks_count": 3,
  "content": "We are open Monday to Friday, 9am to 5pm...",
  "content_available": true,
  "char_count": 43
}

דוגמה (cURL)

curl "https://asyntai.com/api/v1/knowledge/abc-123-def/" \
  -H "Authorization: Bearer YOUR_API_KEY"

DELETE /knowledge/{id}/

מחק רשומת מאגר ידע. ניתן למצוא את ה-id מתגובת GET /knowledge/.

תגובה

{
  "success": true,
  "message": "Knowledge base entry deleted"
}

דוגמה (cURL)

curl -X DELETE "https://asyntai.com/api/v1/knowledge/abc-123-def/" \
  -H "Authorization: Bearer YOUR_API_KEY"

טיפ: תוכל גם לנהל webhooks מתוך הגדרות API דף ללא כתיבת קוד.

GET /webhooks/

הצג את ה-webhooks הרשומים שלך.

תגובה

{
  "success": true,
  "webhooks": [
    {
      "id": "abc-123-def",
      "url": "https://example.com/webhook",
      "events": ["message.received", "escalation.requested"],
      "is_active": true,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ]
}

דוגמה (cURL)

curl "https://asyntai.com/api/v1/webhooks/" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST /webhooks/

רשום webhook חדש לקבלת התראות אירועים בזמן אמת.

אירועים זמינים

אירוע	תיאור
`message.received`	מבקר שלח הודעה וקיבל תגובה
`conversation.started`	מפגש צ'אט חדש הותחל
`escalation.requested`	ה-AI הפעיל העברה לנציג אנושי
`takeover.started`	נציג אנושי השתלט על מפגש צ'אט

גוף הבקשה

{
  "url": "https://example.com/webhook",
  "events": ["message.received", "escalation.requested"],
  "website_id": "123"
}

פרמטר	סוג	נדרש	תיאור
`url`	string	כן	כתובת HTTPS לקבלת בקשות POST של webhook
`events`	array	כן	רשימת אירועים להרשמה (ראה טבלה למעלה)
`website_id`	string	לא	אתר יעד (ברירת מחדל: האתר הראשי שלך)

תגובה

{
  "success": true,
  "webhook": {
    "id": "abc-123-def",
    "url": "https://example.com/webhook",
    "events": ["message.received", "escalation.requested"],
    "secret": "whsec_abc123...",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

אימות webhooks: כל webhook כולל secret (מוצג רק בעת יצירה). כל POST לכתובת שלך כולל X-Webhook-Signature כותרת — HMAC-SHA256 של גוף הבקשה חתום עם הסוד שלך.

דוגמה (cURL)

curl -X POST "https://asyntai.com/api/v1/webhooks/" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/webhook", "events": ["message.received"]}'

DELETE /webhooks/{id}/

מחק webhook. ניתן למצוא את ה-id מתגובת GET /webhooks/.

תגובה

{
  "success": true,
  "message": "Webhook deleted"
}

דוגמה (cURL)

curl -X DELETE "https://asyntai.com/api/v1/webhooks/abc-123-def/" \
  -H "Authorization: Bearer YOUR_API_KEY"

תגובות שגיאה

כל תגובות השגיאה עוקבות אחר פורמט זה:

{
  "success": false,
  "error": "Error message describing what went wrong"
}

קוד סטטוס	תיאור
`400`	בקשה שגויה - פרמטרים לא תקינים או שדות חובה חסרים
`401`	לא מורשה - מפתח API לא תקין או חסר
`429`	יותר מדי בקשות - הגעת למגבלת ההודעות של התוכנית שלך
`503`	שירות לא זמין - שירות ה-AI לא זמין באופן זמני

מגבלות קצב

השימוש ב-API מוגבל לפי תוכנית המנוי שלך:

Free: 100 הודעות/חודש
Starter ($39/חודש): 2,500 הודעות/חודש
Standard ($139/חודש): 15,000 הודעות/חודש
Pro ($449/חודש): 50,000 הודעות/חודש

צריך עזרה?

אם יש לך שאלות או שנתקלת בבעיות, צור קשר איתנו ב-[email protected].