תיעוד API—sem.chat|REST API למפתחים

תחילת העבודה

ה-sem.chat API מאפשר לך לנהל באופן פרוגרמטי שיחות, לשלוח הודעות ולגשת לניתוח. כל בקשות API דורשות אימות באמצעות מפתח API.

https://api.sem.chat/v1

כלול את מפתח API שלך בכותרת ההרשאה של כל הבקשות:

Authorization: Bearer your_api_key_here

GET /conversations

אחזר רשימה של כל השיחות עבור החשבון שלך.

פָּרָמֶטֶר	סוּג	תֵאוּר
לְהַגבִּיל	מִספָּר שָׁלֵם	מספר התוצאות להחזר (מקסימום 100)
לְקַזֵז	מִספָּר שָׁלֵם	מספר התוצאות שיש לדלג עליהן
סטָטוּס	חוּט	סינון לפי סטטוס: פעיל, סגור, בהמתנה

GET /conversations/{id}

אחזר פרטים של שיחה ספציפית כולל כל ההודעות.

POST /conversations

התחל שיחה חדשה באופן פרוגרמטי.

POST /conversations/{id}/messages

שלח הודעה לשיחה קיימת.

// Example request body
{
  "content": "Hello, how can I help you today?",
  "sender": "agent"
}

הגדר webhooks כדי לקבל התראות בזמן אמת על אירועי שיחה.

בקשות API מוגבלות כדי להבטיח שימוש הוגן: