سرویس ثبت گروهی جواب آزمایش‌های بالینی وزارت بهداشت

1. احراز هویت و دریافت توکن (OAuth2)

برای فراخوانی سرویس‌ها، ابتدا باید توکن دسترسی دریافت کنید:

• آدرس:
  POST https://apigateway.behdasht.gov.ir/oauth/token

• هدرها:

Content-Type: application/x-www-form-urlencoded
Authorization: Basic {authorizationCode} // Base64(ClientId:ClientSecret)

پارامترهای body:

grant_type=password
username=your-username
password=your-password

پاسخ موفق:

{
  "access_token": "توکن",
  "token_type": "bearer",
  "refresh_token": "توکن_تازه‌سازی",
  "expires_in": 763,
  "scope": "trust read write"
}

در صورت انقضا توکن، از grant_type=refresh_token و refresh_token استفاده کنید

2. فراخوانی سرویس ثبت گروهی جواب آزمایش

آدرس تستی و اصلی:

https://apigateway.behdasht.gov.ir/api/client/apim/v1/sepas/gwlaboratoryresult/LISSaveLaboratoryResultTest
https://apigateway.behdasht.gov.ir/api/client/apim/v1/sepas/gwlaboratoryresult/LISSaveLaboratoryResult

متد: POST

هدر:

Authorization: Bearer {access_token}
Content-Type: application/json

ساختار ورودی (data شامل آرایه‌ای از پیام‌ها):

{
  "data": [
    {
      "msgID": {
        "systemID": {...},
        "healthCareFacilityID": {...},
        ...
      },
      "composition": {
        "admission": {...},
        "generalLaboratoryResult": {...}
      },
      ...
    }
  ]
}

هر رکورد شامل کلاس‌های داده‌ای مانند:

• PersonInfoVO

• AdmissionVO

• GeneralLaboratoryResultVO

• LabTestResultVO

• SpecimenDetailsVO و غیره است

کات مهم برای توسعه API

• پیاده‌سازی مبتنی بر RESTful API است.

• همه درخواست‌ها باید از طریق HTTPS ارسال شوند.

• هر پیام باید شامل شناسه مرکز، شناسه دانشگاه، شناسه پزشک، و اطلاعات پذیرش باشد.

• کلاس‌ها و فیلدهای داده در سند به‌صورت دقیق تعریف شده‌اند و باید طبق همان ارسال شوند.

پیاده سازی بهینه این سرویس برای نرم افزار شما یا توسعه نرم افزار برای این سرویس توسط تیم مرکز توسعه بودجکس انجام میشود.