תכנון API

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

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