API چیست؟ مفاهیم پایه
میخوایم بفهمیم این غول سه حرفی واقعاً چی کار میکنه!
API: گارسون دنیای دیجیتال!
API (رابط برنامهنویسی اپلیکیشن) یه واسطه نرمافزاریه که به دو تا اپلیکیشن اجازه میده با هم حرف بزنن. همون مثال رستوران رو یادت بیار:
- شما (کلاینت): کسی که یه چیزی میخواد (مثلاً اطلاعات آب و هوا).
- آشپزخونه (سرور): جایی که اون چیز (اطلاعات) آماده میشه.
- گارسون (API): درخواست شما رو به آشپزخونه میبره و جواب رو براتون میاره.
پس API یه سری قوانین و ابزار از پیش تعریف شدهست که مشخص میکنه برنامهها چطوری باید با هم تعامل کنن.
REST API: محبوبترین نوع گارسون!
REST (Representational State Transfer) یه سبک معماری برای طراحی APIهاست. APIهایی که از این سبک پیروی میکنن رو RESTful API میگن. اینا یه سری ویژگی دارن که کار باهاشون رو خیلی ساده و استاندارد میکنه. مهمترین بخشش استفاده از متدهای استاندارد HTTP هست:
| متد HTTP | کاربرد | مثال |
|---|---|---|
| GET | گرفتن و خوندن اطلاعات | /users/123 |
| POST | ایجاد یه منبع جدید | /users |
| PUT / PATCH | آپدیت کردن یه منبع موجود | /users/123 |
| DELETE | حذف کردن یه منبع | /users/123 |
JSON: زبان مشترک گارسون و آشپزخونه!
وقتی گارسون (API) جواب رو از آشپزخونه (سرور) میگیره، باید به یه زبونی باشه که شما (کلاینت) بفهمی. JSON (JavaScript Object Notation) همون زبون مشترکه. یه فرمت متنی خیلی ساده و سبک برای تبادل اطلاعات که هم برای آدما خواناست و هم برای ماشینها. خیلی شبیه آبجکتهای جاوااسکریپته!
{
"id": 1,
"name": "علی رضایی",
"username": "ali_reza",
"email": "ali@example.com",
"isAdmin": false,
"skills": ["PHP", "JavaScript", "Python"]
}