API

💡 A good API hides complexity and exposes intentions, letting small teams build big features without begging for undocumented favors.

یک API خوب پیچیدگی را پنهان و نیات را آشکار می‌کند و به تیم‌های کوچک اجازه می‌دهد بدون التماس برای دریافت کمک‌های مستند نشده، ویژگی‌های بزرگی بسازند.

💡 Make the API docs readable enough that a tired engineer at 2 a.m. can still succeed without calling a friend.

مستندات API را به اندازه‌ای خوانا کنید که یک مهندس خسته ساعت ۲ بامداد بتواند بدون تماس با دوستش به کار خود ادامه دهد.

💡 Our vendor’s API flagged “acr” as an account credit reason, confusing analysts until we updated the glossary.

رابط برنامه‌نویسی کاربردی (API) فروشنده ما «acr» را به عنوان دلیل اعتبار حساب علامت‌گذاری کرد و تحلیلگران را تا زمانی که واژه‌نامه را به‌روزرسانی کردیم، گیج کرد.

💡 Rate limits exist so everyone shares the API politely; caching and backoff keep friendships intact.

محدودیت‌های نرخ وجود دارد، بنابراین همه API را مودبانه به اشتراک می‌گذارند؛ ذخیره‌سازی و حذف موقت، دوستی‌ها را حفظ می‌کند.

💡 Before publishing an API, we wrote examples and tests, turning promises into durable contracts.

قبل از انتشار یک API، ما مثال‌ها و آزمایش‌هایی نوشتیم و وعده‌ها را به قراردادهای بادوام تبدیل کردیم.

💡 A predictable API delights developers more than a flashy one that changes moods every release.

یک API قابل پیش‌بینی، توسعه‌دهندگان را بیشتر از یک API پر زرق و برق که با هر انتشار، حال و هوا را تغییر می‌دهد، خوشحال می‌کند.

💡 The API expects a denom like “USD” or “EUR,” not symbols or localized strings.

این API انتظار یک واحد پولی مانند «USD» یا «EUR» را دارد، نه نمادها یا رشته‌های محلی.

💡 Okay, that does it—we’re rewriting the API docs tonight.

خب، این کافی است—امشب مستندات API را بازنویسی می‌کنیم.

💡 The manual’s expliˈcation finally made the API click.

توضیحات راهنما بالاخره باعث شد API فعال شود.