تیمچه دیجیتالی در توریست پنل

توریست پنل، تیمچه‌ای مدرن در صنعت گردشگری دیجیتال ایران

✅دسترسی کاربران به تأمین‌کنندگان معتبر سریع‌تر و آسان‌تر شود.

✅ شفافیت در خدمات و قیمت‌گذاری افزایش یابد.

✅ مدیریت کسب‌وکارهای گردشگری ساده‌تر و کارآمدتر گردد.

****

این راهنما شامل اطلاعاتی درباره احراز هویت، دریافت دسته‌بندی‌ها، لیست برنامه‌ها، جزئیات برنامه‌ها، انواع بلیط، لیست سانس‌ها، ساخت سبد خرید و نهایی‌سازی آن است. محیط هر دو Sandbox و Production پشتیبانی می‌شوند.

۱. آدرس‌های API در محیط‌های مختلف

Sandbox API

Swagger URL:

							
https://marketplace-api.0tp.ir/swagger/index.html
    

Base URLs:

								https://id.0tp.ir
								https://app.0tp.ir
								https://supplychain-api.0tp.ir
								https://marketplace-api.0tp.ir
							

Production API

Base URLs:

								https://id.touristpanel.ir
								https://app.touristpanel.ir
								https://supplychain-api.touristpanel.ir
								https://marketplace-api.touristpanel.ir
							

📌 نکته بسیار مهم: Base URL برای تصاویر

Staging Environment:

							  https://dsfiles.0tp.ir
    

Production Environment:

							  https://files.0tp.ir/
    

۲. پیش‌نیازها

✅ قبل از استفاده از API، اطمینان حاصل کنید که:

به کنسول مدیریت پنل گردشگری دسترسی دارید.

مجوز ایجاد ClientId و ClientSecret را دارید.

۳. احراز هویت (Authentication)

سیستم احراز هویت از OAuth2 Password Flow استفاده می‌کند.

🔹 مرحله ۱: ورود به کنسول مدیریت پنل گردشگری

1. وارد کنسول مدیریت پنل شوید.

2. به مدیریت پنل → تنظیمات پنل بروید.

3. گزینه مجوز دستگاه‌ها را انتخاب کنید.

🔹 مرحله ۲: ایجاد یک کلاینت جدید

1. روی افزودن مجوز کلیک کنید.

2. Client ID و Client Secretذخیره کنید نمایش داده‌شده را .

📌 توجه: Client Secret فقط یک بار نمایش داده می‌شود. آن را کپی کرده و به‌صورت امن ذخیره کنید .

۴. احراز هویت با API (Authentication API)

برای احراز هویت درخواست‌های API از OAuth2 استفاده کنید.

🔹 مرحله ۱: دریافت Access Token

📌 آدرس دریافت توکن:

							
https://id.0tp.ir/connect/token
    

📌 هدرهای درخواست:

							
Content-Type: application/x-www-form-urlencoded
    

📌 پارامترهای Body در درخواست:

📌نمونه درخواست cURL:

curl -X POST https://id.0tp.ir/connect/token
H "Content-Type: application/x-www-form-urlencoded"
H "__tenant: your_tenant" 
d "grant_type=password"
d "client_id=YourClientID"
d "client_secret=YourClientSecret"
d "username=UserUsername"
d "password=UserPassword"
d "scope=B2CApi Mobile"
    

📌نمونه Response:

   }
							
 , "access_token": "your_access_token_here" 
							
 ,"expires_in": 3600 
							
 "token_type": "Bearer"
    {
    

🔹 مرحله ۲: استفاده از Access Token

📌توکن access_token را در Header درخواست‌های API قرار دهید:

📌نام tenant را در Header درخواست‌های API قرار دهید:

📌نمونه Header:

							
Authorization: Bearer your_access_token_here
							
__tenant: your_tenant
    

✅ این راهنما شامل تمام اطلاعات موردنیاز برای احراز هویت و استفاده از API پنل گردشگری است.

✅ در صورت داشتن هرگونه سوال، لطفاً مستندات Swagger را بررسی کنید.