🚀🔍 חדש! בדיקת API חיה – רואים בדיוק איפה התקלה

[פתרון AI]

כלי חדש: בדיקת API חיה מתוך השלוחה

מי שעובד עם שלוחות API מכיר כנראה את הסיטואציה הזאת:

הגדרתם api_link, השרת נראה תקין, אולי אפילו פתחתם את הכתובת בדפדפן והכול עובד — אבל בשיחה מקבלים "אין מענה משרת API".

ומפה מתחילים הניחושים.

האם ימות בכלל שלחו בקשה?
האם היא הגיעה לשרת?
אולי השרת החזיר 500?
אולי יש Redirect?
אולי התגובה נראית תקינה אבל יש בה תו נסתר?
ואולי בכלל התגובה הגיעה לימות, אבל משהו בתוכה לא ניתן לביצוע?

בשביל זה הוספנו באתר בדיקת API חיה, ישירות בתוך שלוחת API.

לא צריך לפתוח כלי חיצוני ולא צריך להעתיק ידנית את ההגדרות.

נכנסים לשלוחה, עוברים ללשונית "בדיקת API", לוחצים על התחלת בדיקה ומבצעים שיחה רגילה לשלוחה.

בזמן הבדיקה האתר מעביר את הפנייה של ימות דרך שרת בדיקה אל שרת ה־API האמיתי שלכם, וכך ניתן לראות את כל הדרך שעברה הבקשה.

במקום לקבל רק הודעה כללית של "אין מענה", אפשר לראות למשל:

• האם הגיעה פנייה מימות
• אילו פרמטרים נשלחו
• האם השרת שלכם קיבל את הבקשה
• איזה HTTP Status השרת החזיר
• כמה זמן לקח לו לענות
• מה בדיוק השרת החזיר
• האם מבנה התגובה תקין לשלוחת API
• והאם אפשר לאמת את התוצאה מול LogApi של ימות

מעבר לזה, המערכת מנסה לזהות לבד תקלות נפוצות כמו 500, ‏Redirect, Timeout, תשובת HTML או JSON במקום תשובת API, ‏BOM ותווים נסתרים, שגיאות במחרוזת התגובה ועוד.

יש גם אבחון מעמיק.

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

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

המטרה היא שבסוף הבדיקה לא תקבלו רק ערימה של לוגים, אלא תשובה פשוטה בסגנון:

"מצאנו את התקלה: השרת החזיר HTTP 500"

או:

"השרת ענה בהצלחה, אבל התגובה אינה בפורמט תקין לימות"

או:

"התגובה תקינה, אבל היא מפנה לקובץ שלא קיים"

וכמובן, כשלא נמצאה בעיה:

"לא נמצאה בעיה — הבקשה הגיעה, השרת ענה והתגובה עברה את הבדיקות."

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

זו כרגע גרסה ראשונה, ויש עוד לא מעט דברים שאפשר להוסיף בהמשך.

אשמח במיוחד לשמוע ממי שעובד הרבה עם מודול API:
איזו תקלה הכי קשה לכם היום לאבחן?

הכנסו לאתר https://ivr.pitronai.com/
ואז לשלוחת API ותוכלו לבצע את הבדיקות