بررسی لوکیشن

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

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

در صورتی که می‌خواهید با استفاده از موقعیت جغرافیایی، نزدیک‌ترین گنجه شناسایی شود و توکن مربوط به آن را دریافت کنید، می‌توانید با استفاده از فیلد‌های 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
200	return location token
400	Station 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
200	return location token
400	Station not found

سایر نکات

tip

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

info

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

  Either lat and long or slug must be provided