קריאת התשובה המלאה
בסטטוס כושל, שמרו את קוד ה-HTTP, הכותרות, גוף השגיאה ומזהה הבקשה לאחר הסרת סודות. הם מבדילים בין בקשה לא תקינה, דחיית גישה ותקלה זמנית.
אל תחשפו תשובת שירות גולמית כהודעת המשתמש היחידה: הסבירו את הפעולה תוך שמירת פרטי אבחון למפעיל.
בדיקת תשובה שנכשלה
bash
curl --include --request POST https://cicora.ai/api/v1/chat/completions \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"model":"openai/gpt-5.6-sol","messages":[]}'סיווג הכשל
- 4xx מחייב בדרך כלל תיקון מפתח, נתוני קלט או גישה.
- 429 מחייב לכבד את חלון המגבלה ולהימנע מניסיון חוזר אגרסיבי.
- כשלים מסוג 5xx וכשלי רשת מחייבים מספר מוגבל של ניסיונות חוזרים, עם השהיה מעריכית ואקראיות.
ניסיון חוזר בטוח
נסו שוב רק כשלים זמניים ורק אם הפעולה אידמפוטנטית במוצר שלכם. ביצירה, שמרו מזהה בקשת לקוח כדי למנוע חיוב כפול או תוצר כפול.
בהזרמה, הבחינו בין שגיאה לפני מקטע העדכון הראשון לבין ניתוק לאחר פלט חלקי: אי אפשר להחליף את האחרון בשקט בתשובה חדשה.