ایجاد مکان منتخب (Post)
برای ثبت یک مکان بهعنوان مکان منتخب استفاده میشود.
اطلاعات عمومی
- آدرس:
/api/v2/place
- متد:
POST
- نوع خروجی:
application/json
- احراز هویت: نیازمند token
پارامترهای بدنه درخواست (Body)
نام پارامتر | نوع | توضیحات |
---|---|---|
lat | number | عرض جغرافیایی مکان |
lng | number | طول جغرافیایی مکان |
detailed_address | string | آدرس دقیق مکان |
name | string | نام مکان |
نمونه درخواست
curl -X POST "https://corporate.snapp.site/api/v2/place" \
-H "Authorization: <your_authorization_token>" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data-raw '{"lat":35.69978618515982,"lng":51.33777010101795,"detailed_address":"test","name":"test"}'
پاسخ موفق
{
"message": "new place stored successfully",
"data": null,
"status": 200
}
کدهای وضعیت و خطاها
کد وضعیت | توضیحات |
---|---|
200 | درخواست با موفقیت انجام شد و مکان جدید ذخیره شد |
400 | درخواست نامعتبر است (مثلاً پارامترهای نامعتبر ارسال شدهاند) |
401 | عدم احراز هویت (توکن JWT نامعتبر یا منقضیشده است) |
403 | دسترسی غیرمجاز |
500 | خطای داخلی سرور |