← صفحه ورود
📘

راهنمای استفاده از وب سرویس

مستندات داروواچ

🔹 معرفی سامانه

این وب سرویس اطلاعات دارویی، امکان جستجو و دریافت اطلاعات داروها را به صورت JSON فراهم می‌کند. برای استفاده از سرویس، ابتدا باید وارد حساب کاربری خود شوید.

⚠️ نکته مهم: تمام درخواست‌ها نیاز به احراز هویت دارند. بدون لاگین موفق یا دریافت توکن دسترسی به API امکان‌پذیر نیست.

🔹 نحوه ورود به سیستم

برای ورود به پنل، مراحل زیر را طی کنید:

  1. مرورگر خود را باز کنید و آدرس زیر را وارد کنید: http://daroowatch.com/login.php
  2. نام کاربری و رمز عبور خود را وارد کنید
  3. پس از ورود موفق، به صفحه اصلی API هدایت می‌شوید.

🔹 آدرس پایه وب سرویس

http://daroowatch.com/api.php

تمامی درخواست‌ها باید به این آدرس ارسال شوند.

🔹 پارامترهای جستجو

برای جستجوی دارو، از پارامتر search استفاده کنید. پارامتر type نیز مشخص می‌کند در کدام فیلد جستجو انجام شود.

📌 پارامتر required search

متن جستجو (نام دارو، کد ژنریک یا ...). مثال: search=تریامسینولون

📌 پارامتر optional type

نوع جستجو. مقادیر ممکن:

  • all (پیش‌فرض) - جستجو در همه فیلدها
  • persian_name - جستجو در نام فارسی دارو
  • english_name - جستجو در نام انگلیسی دارو
  • jeneric - جستجو در کد ژنریک

🔹 مثال‌های عملی

مثال 1: جستجوی ساده

http://daroowatch.com/api.php?search=تریامسینولون

مثال 2: جستجو فقط در نام فارسی

http://daroowatch.com/api.php?search=تریامسینولون&type=persian_name

مثال 3: جستجو با کد ژنریک

http://daroowatch.com/api.php?search=1247&type=jeneric

مثال 4: جستجو با حروف انگلیسی

http://daroowatch.com/api.php?search=TRIAMCINOLONE&type=english_name

🔹 فرمت خروجی JSON

خروجی در صورت موفقیت شامل اطلاعات زیر است:

{ "status": "success", "count": 2, "search_term": "تریامسینولون", "search_type": "all", "data": [ { "sparvane": "یارا طب خاورمیانه", "jeneric": "1247", "price": "550,000", "english_name": "(TRIAMCINOLONE ACETONIDE INJECTION...)", "persian_name": "تریامسینولون تزریقی..." } ] }

📋 توضیح فیلدهای خروجی:

  • status - وضعیت درخواست (success/error/info)
  • count - تعداد نتایج یافت شده
  • search_term - عبارت جستجو شده
  • search_type - نوع جستجو
  • data - آرایه حاوی اطلاعات داروها

📦 فیلدهای هر دارو:

  • sparvane صاحب پروانه
  • jeneric - کد ژنریک دارو
  • price - قیمت دارو (ریال)
  • english_name - نام انگلیسی دارو
  • persian_name - نام فارسی دارو

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

کد وضعیت معنی توضیح
200 موفق درخواست با موفقیت انجام شد
401 عدم احراز هویت لطفا ابتدا وارد سایت شوید
429 درخواست زیاد محدودیت تعداد درخواست

پیام‌های خطای احتمالی در JSON:

{"error": "لطفا ابتدا وارد سایت شوید", "login_url": "login.php"}
{"status": "info", "message": "لطفا پارامتر search را وارد کنید"}