پرش به مطلب اصلی

بررسی لوکیشن

برای بررسی لوکیشن و گرفتن توکن جهت باز کردن درب گنجه، می‌توانید از این وب‌سرویس استفاده کنید.

با استفاده از موقعیت جغرافیایی​

در صورتی که می‌خواهید با استفاده از موقعیت جغرافیایی، نزدیک‌ترین گنجه شناسایی شود و توکن مربوط به آن را دریافت کنید، می‌توانید با استفاده از فیلد‌های lat و long این کار را انجام دهید. نمونه:

POST/v1.1/infrastructure/station-location-validation/
نیاز به احراز هویت

Request Body​

{
  "lat": 35.7527,
  "long": 51.3745
}

Response Body​

{
  "location_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjo5LCJzdGF0aW9uIjoiMDVkZGZmYTEtNTRlYy00YTBmLWE5N2EtYWMxODc5MmNmYTAzIiwidGltZXN0YW1wIjoiMjAyNC0xMS0wOSAxMTo1MDoyMiJ9.N77WBVFc3WbYMDzZT01nEBs7eCC1qpvr9z038OKDxJc"
}

Response Codes​

Status Code Description
200return location token
400Station not found

با استفاده از کد یکتای گنجه (slug)​

در صورتی که می‌خواهید با استفاده از کد ۸ رقمی یکتای گنجه، توکن را دریافت کنید، می‌توانید از فیلد slug استفاده کنید. نمونه:

POST/v1.1/infrastructure/station-location-validation/
نیاز به احراز هویت

Request Body​

{
  "slug": "11975406"
}

Response Body​

{
  "location_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjo5LCJzdGF0aW9uIjoiMDVkZGZmYTEtNTRlYy00YTBmLWE5N2EtYWMxODc5MmNmYTAzIiwidGltZXN0YW1wIjoiMjAyNC0xMS0wOSAxMTo1MDoyMiJ9.N77WBVFc3WbYMDzZT01nEBs7eCC1qpvr9z038OKDxJc"
}

Response Codes​

Status Code Description
200return location token
400Station not found

سایر نکات​

نکته

مقدار فیلد location_token برای فراخوانی وب‌سرویس باز کردن درب گنجه، استفاده خواهد شد.

اطلاع

  • در صورتی که هیچ‌کدام از فیلد‌های slug یا lat و long را در درخواست قرار نداده باشید، با ارور زیر مواجه خواهید شد:

    Either lat and long or slug must be provided