API для встраивания

DL_CORS_ORIGINS=https://clinic.example,https://www.clinic.example

Форма расшифровки на вашем сайте

Готовый фрагмент HTML и JavaScript: пользователь входит своим логином Justmedit прямо на сайте клиники, затем пол, возраст, гемоглобин и ферритин → главный вывод для пациента. Токен из ответа входа живёт только в памяти вкладки: закрыл вкладку — вошёл заново. Ответ выводится через textContent — никакого HTML из ответа на странице.

<!-- Форма расшифровки анализа на сайте клиники (домен сайта — в DL_CORS_ORIGINS сервиса).
     Пользователь входит своим логином Justmedit; токен из ответа — только в памяти вкладки (переменная token).
     Токен не вставляйте в код страницы. Ключ X-API-Key в браузер не кладите. -->
<form id="jm-login">
  <label>Логин Justmedit <input name="login" autocomplete="username" required></label>
  <label>Пароль <input name="password" type="password" autocomplete="current-password" required></label>
  <button>Войти</button>
</form>
<form id="jm-form" hidden>
  <label>Пол
    <select name="sex"><option value="F">женский</option><option value="M">мужской</option></select>
  </label>
  <label>Возраст, лет <input name="age" type="number" min="18" max="120" required></label>
  <label>Гемоглобин, г/л <input name="hemoglobin" type="number" step="0.1" required></label>
  <label>Ферритин, мкг/л <input name="ferritin" type="number" step="0.1"></label>
  <button>Расшифровать</button>
</form>
<p id="jm-out" aria-live="polite"></p>

<script>
const JUSTMEDIT = "https://justmedit.example";      // адрес сервиса Justmedit
let token = null;                                    // токен — только в памяти вкладки, нигде не сохраняется
const loginForm = document.getElementById("jm-login");
const form = document.getElementById("jm-form");
const out = document.getElementById("jm-out");

function signedIn(on) { loginForm.hidden = on; form.hidden = !on; }

loginForm.addEventListener("submit", async (event) => {
  event.preventDefault();
  const f = new FormData(loginForm);
  out.textContent = "Входим…";
  try {
    const res = await fetch(JUSTMEDIT + "/api/v1/auth/login", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ login: f.get("login"), password: f.get("password") })
    });
    const data = await res.json();
    loginForm.reset();                                 // пароль не остаётся в форме
    if (!res.ok) { out.textContent = data.error.message; return; }
    token = data.token;
    signedIn(true);
    out.textContent = "Вы вошли как " + data.user.login + ".";
  } catch (e) {
    out.textContent = "Сервис недоступен. Попробуйте позже.";
  }
});

form.addEventListener("submit", async (event) => {
  event.preventDefault();
  const f = new FormData(form);
  const values = { hemoglobin: Number(f.get("hemoglobin")) };
  if (f.get("ferritin")) values.ferritin = Number(f.get("ferritin"));
  out.textContent = "Считаем…";
  try {
    const res = await fetch(JUSTMEDIT + "/api/v1/analyze", {
      method: "POST",
      headers: { "Authorization": "Bearer " + token, "Content-Type": "application/json" },
      body: JSON.stringify({ sex: f.get("sex"), age_years: Number(f.get("age")), values })
    });
    const data = await res.json();
    if (res.status === 401) {                          // токен истёк или отозван — войти заново
      token = null;
      signedIn(false);
      out.textContent = "Сеанс завершён — войдите снова.";
      return;
    }
    out.textContent = res.ok ? data.reports.patient.headline : data.error.message;
  } catch (e) {
    out.textContent = "Сервис недоступен. Попробуйте позже.";
  }
});
</script>

Кабинет пациента через API

Пять запросов: регистрация, вход, сохранить анализ, получить динамику, открыть доступ врачу. Тела — JSON с заголовком Content-Type: application/json. Код 201 — у регистрации и новой записи, остальные — 200. Логин и пароль — свои, в переменных окружения $JUSTMEDIT_LOGIN и $JUSTMEDIT_PASSWORD: пароль не пишите в команду и в код. Анализы в кабинете хранятся зашифрованными; удалить всё — DELETE /api/v1/me с паролем.

1. POST /api/v1/auth/register — регистрация

   # свой логин и пароль: read -s не покажет пароль и не оставит его в истории команд
   export JUSTMEDIT_LOGIN="dev-$(openssl rand -hex 3)"
   read -rs -p "Пароль (от 8 символов): " JUSTMEDIT_PASSWORD; echo; export JUSTMEDIT_PASSWORD
   curl -sS -X POST "https://justmedit.example/api/v1/auth/register" \
     -H "Content-Type: application/json" \
     -d "{\"login\": \"$JUSTMEDIT_LOGIN\", \"password\": \"$JUSTMEDIT_PASSWORD\", \"role\": \"patient\", \"consent\": true}"

2. POST /api/v1/auth/login — вход, токен в переменную

   export JUSTMEDIT_TOKEN=$(curl -sS -X POST "https://justmedit.example/api/v1/auth/login" \
     -H "Content-Type: application/json" \
     -d "{\"login\": \"$JUSTMEDIT_LOGIN\", \"password\": \"$JUSTMEDIT_PASSWORD\"}" \
     | python3 -c 'import json, sys; print(json.load(sys.stdin)["token"])')

3. POST /api/v1/me/records — сохранить анализ и получить расшифровку

   curl -sS -X POST "https://justmedit.example/api/v1/me/records" \
     -H "Authorization: Bearer $JUSTMEDIT_TOKEN" -H "Content-Type: application/json" \
     -d '{"date": "2026-04-16", "source": "form",
          "input": {"sex": "F", "age_years": 34, "values": {"hemoglobin": 124, "MCV": 82, "RDW": 15.2}}}'

4. GET /api/v1/me/history — динамика и что давно не сдавалось

   curl -sS "https://justmedit.example/api/v1/me/history" -H "Authorization: Bearer $JUSTMEDIT_TOKEN"

5. POST /api/v1/me/shares — доступ врачу на 30 дней

   По токену API ссылку врачу создают только с паролем аккаунта в поле password — так же новый токен (POST /api/v1/me/tokens) и «выйти везде» (POST /api/v1/me/logout-all): украденный токен не откроет историю постороннему. Без пароля — 403 password_required, с неверным — 403 wrong_password.

   curl -sS -X POST "https://justmedit.example/api/v1/me/shares" \
     -H "Authorization: Bearer $JUSTMEDIT_TOKEN" -H "Content-Type: application/json" \
     -d "{\"days\": 30, \"password\": \"$JUSTMEDIT_PASSWORD\"}"
   # ответ 200: {"share": {…, "status": "pending"}, "link_token": "…", "link": "/share#…"}
   # ссылка для врача: https://justmedit.example/share#<link_token> (живёт 48 ч, одноразовая)
   # врач со своим токеном: POST /api/v1/shares/accept {"token": "<link_token>"}

• 10 МБтело запроса и файл (DL_MAX_UPLOAD_MB); один анализ JSON — до 256 КБ
• 10 000записей в пакете и строк в файле (DL_MAX_BATCH); 200 столбцов; бланк — до 400 строк
• 2тяжёлых расчёта одновременно (batch, benchmark, columns, parse); иначе 503
• 30 в минутутяжёлых запросов на ключ или токен по умолчанию (DL_UI_RATE_PER_MIN); иначе 429
• 25 Мп · 20 сфото бланка: размер снимка и время распознавания