انواع داده در JSON؛ راهنمای کامل با مثال‌های ساده و کاربردی

شکل
شکل
شکل
شکل
شکل
شکل
شکل
شکل
انواع داده در JSON؛ راهنمای کامل با مثال‌های ساده و کاربردی

انواع داده در JSON

JSON یکی از رایج‌ترین فرمت‌ها برای ذخیره و انتقال داده است. اگر با API، برنامه‌نویسی وب یا تبادل اطلاعات بین سیستم‌ها کار می‌کنید، شناخت انواع داده در JSON ضروری است. این فرمت به دلیل سادگی، خوانایی بالا و سازگاری گسترده، به یک استاندارد محبوب تبدیل شده است. 🚀

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

JSON چیست؟

JSON مخفف JavaScript Object Notation است. این فرمت متنی برای نمایش داده‌های ساخت‌یافته استفاده می‌شود. با JSON می‌توان اطلاعات را به‌شکلی ثبت کرد که هم برای انسان قابل خواندن باشد و هم برای ماشین به‌سادگی پردازش شود.

JSON در ابتدا از فضای جاوااسکریپت شناخته شد، اما امروز تقریباً در تمام زبان‌های برنامه‌نویسی پشتیبانی می‌شود. به همین دلیل، در توسعه وب، اپلیکیشن‌های موبایل، وب‌سرویس‌ها و APIها کاربرد زیادی دارد.

چرا JSON محبوب است؟

چند دلیل اصلی برای محبوبیت JSON وجود دارد:

  • خوانایی بالا برای انسان
  • ساختار ساده و سبک
  • پشتیبانی گسترده در زبان‌های برنامه‌نویسی
  • مناسب برای API و تبادل داده
  • سریع‌تر و کم‌حجم‌تر از برخی فرمت‌های قدیمی‌تر

انواع داده در JSON؛ راهنمای کامل با مثال‌های ساده و کاربردی

انواع داده در JSON

در JSON، هر مقدار باید یکی از نوع‌های داده معتبر باشد. شناخت این نوع‌ها پایه کار با JSON است.

1) String در JSON

رشته یا String برای نگهداری متن استفاده می‌شود. در JSON، رشته‌ها باید حتماً داخل دابل کوتیشن قرار بگیرند.

json
{ "name": "John" }

نکته مهم این است که در JSON، استفاده از تک کوتیشن برای رشته معتبر نیست. پس این ساختار نادرست است:

json
{ "name": 'John' }

2) Number در JSON

عدد در JSON می‌تواند صحیح یا اعشاری باشد.

json
{ "age": 30 }

یا:

json
{ "price": 19.99 }

در JSON، اعداد بدون کوتیشن نوشته می‌شوند. اگر عدد را داخل کوتیشن بگذارید، دیگر عدد نیست و به رشته تبدیل می‌شود.

3) Object در JSON

شیء یا Object یکی از مهم‌ترین انواع داده در JSON است. آبجکت داخل آکولاد {} نوشته می‌شود و شامل مجموعه‌ای از جفت‌های کلید و مقدار است.

json
{
  "employee": {
    "name": "John",
    "age": 30,
    "city": "New York"
  }
}

در هر شیء، نام کلیدها باید در دابل کوتیشن قرار بگیرند.

4) Array در JSON

آرایه یا Array برای نگهداری چند مقدار استفاده می‌شود. آرایه داخل کروشه [] قرار می‌گیرد.

json
{
  "employees": ["John", "Anna", "Peter"]
}

آرایه در JSON می‌تواند شامل رشته، عدد، شیء، بولی یا حتی آرایه‌های دیگر باشد.

5) Boolean در JSON

مقدار بولی در JSON فقط دو حالت دارد: true یا false.

json
{ "sale": true }

این مقادیر نباید داخل کوتیشن قرار بگیرند. در غیر این صورت، به رشته تبدیل می‌شوند.

6) Null در JSON

مقدار null برای نمایش نبودن داده یا خالی بودن مقدار استفاده می‌شود.

json
{ "middlename": null }

وقتی داده‌ای وجود ندارد، استفاده از null راهی استاندارد و شفاف است.

انواع داده نامعتبر در JSON

JSON همه نوع داده را نمی‌پذیرد. برخی انواع داده باید قبل از ذخیره یا ارسال، به فرم قابل قبول تبدیل شوند.

داده‌هایی که در JSON معتبر نیستند

  • function
  • date
  • undefined

برای مثال، اگر بخواهید تاریخ را در JSON ذخیره کنید، معمولاً باید آن را به رشته تبدیل کنید:

json
{ "createdAt": "2026-05-02T10:30:00Z" }

قوانین مهم نوشتن JSON

برای اینکه داده‌ها به‌درستی پردازش شوند، باید چند قانون پایه را رعایت کنید. این بخش برای هر کسی که با انواع داده در JSON کار می‌کند، بسیار مهم است. 📌

قواعد اصلی JSON

  • 🧩 اشیا باید داخل آکولاد {} قرار بگیرند.
  • 🧩 آرایه‌ها باید داخل کروشه [] قرار بگیرند.
  • 🧩 اعضای هر شیء با ویرگول , از هم جدا می‌شوند.
  • 🧩 بین کلید و مقدار باید از دونقطه : استفاده شود.
  • 🧩 نام کلیدها باید در دابل کوتیشن قرار بگیرند.
  • 🧩 رشته‌ها باید در دابل کوتیشن قرار بگیرند.
  • 🧩 مقدارها فقط باید از نوع string، number، object، array، boolean یا null باشند.

یک نمونه صحیح از JSON

json
{
  "id": 1,
  "name": "megaweb",
  "active": true,
  "tags": ["api", "json", "data"],
  "profile": {
    "city": "Tehran"
  },
  "description": null
}

یک نمونه نادرست از JSON

json
{
  name: "megaweb",
  createdAt: new Date(),
  status: undefined
}

در این مثال، کلیدها کوتیشن ندارند، تاریخ به‌صورت مستقیم استفاده شده و undefined نیز نامعتبر است.

مثال عملی از ساختار JSON

در بسیاری از آموزش‌ها، نمونه‌هایی شبیه به جاوااسکریپت و JSON با هم ترکیب می‌شوند. اما باید دقت کرد که هر ساختار جاوااسکریپتی، JSON معتبر نیست.

مثال زیر یک آرایه از اشیا را نشان می‌دهد:

javascript
var companies = [
  { id: 1, name: 'megaweb' },
  { id: 2, name: 'foo' }
];

این کد، ساختار جاوااسکریپت است؛ نه JSON خالص. اگر بخواهیم آن را به JSON معتبر تبدیل کنیم، باید کلیدها و رشته‌ها را با دابل کوتیشن بنویسیم:

json
[
  { "id": 1, "name": "megaweb" },
  { "id": 2, "name": "foo" }
]

این تفاوت، یکی از نکات مهم در درک انواع داده در JSON است.

مزیت‌های JSON

JSON فقط یک فرمت ساده نیست. این ساختار مزیت‌های مهمی دارد که باعث شده در پروژه‌های مدرن بسیار پرکاربرد باشد. ✨

  • سبک و سریع است: حجم کمی دارد و برای انتقال داده مناسب است.
  • 📖 خوانا است: توسعه‌دهنده به‌راحتی می‌تواند ساختار آن را درک کند.
  • 🔄 سازگار است: تقریباً با همه زبان‌ها و پلتفرم‌ها کار می‌کند.
  • 🧠 یادگیری ساده‌ای دارد: قواعد آن محدود و مشخص هستند.
  • 🌐 مناسب برای APIها است: در ارسال و دریافت داده بین کلاینت و سرور عالی عمل می‌کند.

کاربردهای JSON

شناخت کاربردهای انواع داده در JSON کمک می‌کند بهتر درک کنیم چرا این فرمت تا این حد مهم شده است.

  • 🌍 تبادل داده بین فرانت‌اند و بک‌اند
  • 📱 ارسال اطلاعات در اپلیکیشن‌های موبایل
  • 🔌 استفاده در REST API و Web API
  • 🗄️ ذخیره داده‌های ساخت‌یافته
  • 🤖 تنظیمات نرم‌افزارها و فایل‌های کانفیگ
  • ☁️ ارسال داده در سرویس‌های ابری

برای مثال، وقتی یک کاربر در سایت ثبت‌نام می‌کند، اطلاعاتی مثل نام، ایمیل و شماره تماس اغلب با JSON بین فرانت‌اند و سرور جابه‌جا می‌شود.

مقایسه JSON و BSON

در کنار JSON، فرمت دیگری با نام BSON هم وجود دارد. BSON مخفف Binary JSON است. این فرمت بیشتر در MongoDB استفاده می‌شود.

تفاوت اصلی JSON و BSON

JSON یک فرمت متنی است. در مقابل، BSON یک فرمت باینری است. BSON برای ذخیره‌سازی و پردازش سریع‌تر در پایگاه‌های داده سندمحور طراحی شده است.

BSON چه مزیتی دارد؟

  • ✅ برای ایندکس‌گذاری در MongoDB مناسب است
  • ✅ سرعت پردازش بیشتری در برخی سناریوها دارد
  • ✅ از برخی نوع‌های داده بیشتر پشتیبانی می‌کند

با این حال، برای تبادل داده در وب و APIها، JSON همچنان انتخاب رایج‌تر و استانداردتر است.

مراحل ثبت‌نام برای استفاده از API

اگر قصد دارید در پروژه‌های خود با API و JSON کار کنید، معمولاً باید ابتدا ثبت‌نام انجام دهید. این فرایند معمولاً بسیار کوتاه است. 🔐

ثبت‌نام به‌صورت خلاصه

  1. به صفحه ثبت‌نام مراجعه کنید: p.api.ir
  2. اطلاعات اولیه خود را وارد کنید.
  3. حساب کاربری را تأیید کنید.
  4. وارد پنل شوید و کلید API دریافت کنید.
  5. از مستندات API برای ارسال و دریافت JSON استفاده کنید.

این روند برای توسعه‌دهندگانی که می‌خواهند سریع به سرویس متصل شوند، بسیار کاربردی است.

نکات مهم برای کار بهتر با انواع داده در JSON

هنگام کار با JSON، رعایت چند نکته ساده باعث می‌شود خطاهای کمتری داشته باشید:

نکات کاربردی

  • 🛠️ همیشه JSON را با ابزارهای اعتبارسنجی بررسی کنید.
  • 🛠️ بین JSON و آبجکت جاوااسکریپت تفاوت قائل شوید.
  • 🛠️ برای تاریخ، از رشته استاندارد استفاده کنید.
  • 🛠️ از null به‌جای undefined استفاده کنید.
  • 🛠️ کلیدها را شفاف و معنادار انتخاب کنید.

جمع‌بندی

انواع داده در JSON شامل string، number، object، array، boolean و null هستند. این سادگی، یکی از مهم‌ترین دلایل محبوبیت JSON است. اگر قواعد نوشتن JSON را درست رعایت کنید، انتقال داده بین سیستم‌ها بسیار روان‌تر و کم‌خطاتر خواهد شد.

اگر این مقاله برای شما مفید بود، دیدگاه خود را ثبت کنید و تجربه‌تان از کار با JSON را بنویسید. همچنین می‌توانید مقاله‌های مرتبط با API و ساختار داده را هم مطالعه کنید تا درک عمیق‌تری از توسعه وب به‌دست آورید.

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *