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