دریافت مکان منتخب (Get)

برای مشاهده اطلاعات یک مکان منتخب استفاده می‌شود.

---

اطلاعات عمومی

• آدرس: /api/v3/place
• متد: GET
• نوع خروجی: application/json
• احراز هویت: نیازمند token

---

نمونه درخواست

curl "https://corporate.snapp.site/api/v3/place" \
  -H "Authorization: <your_authorization_token>" \
  -H "Accept: application/json"

---

پاسخ موفق

{
    "message": "Success",
    "data": {
        "places": [
            {
                "id": 0,
                "name": "string",
                "detailed_address": "string",
                "location": {
                    "lat": 35.7340829,
                    "lng": 51.482242,
                    "formatted_address": "string"
                }
            }
        ]
    },
    "status": 200
}

---

ساختار پاسخ

نام پارامتر	نوع	توضیحات
message	string	پیام پاسخ
data	object	داده‌های پاسخ
data.places	array	آرایه‌ای از مکان‌ها
data.places.id	integer	شناسه مکان
data.places.name	string	نام مکان
data.places.detailed_address	string	آدرس دقیق مکان
data.places.location	object	اطلاعات موقعیت مکانی
data.places.location.lat	number	عرض جغرافیایی مکان
data.places.location.lng	number	طول جغرافیایی مکان
data.places.location.formatted_address	string	آدرس فرمت شده مکان
status	integer	کد وضعیت پاسخ

---

کدهای وضعیت و خطاها

کد وضعیت	توضیحات
200	درخواست با موفقیت انجام شد و لیست مکان‌ها بازگردانده شد
401	عدم احراز هویت (توکن JWT نامعتبر یا منقضی‌شده است)
403	دسترسی غیرمجاز
500	خطای داخلی سرور