Waafir
Эта страница переведена машинным способом и ожидает проверки человеком. Возможны неточности.

Сверка данных по внешнему ID

Этот рецепт показывает, как замкнуть цикл для отправки данных: подтвердить, что конкретная строка записана, по вашему собственному идентификатору, переданному вызывающей стороной, и проверить, что совокупные количества по каждой сущности совпадают с отправленными. Оба запроса на чтение ограничены вашей организацией и никогда не раскрывают данные другого тенанта.

Почему сверка важна

Сегодня вы отправили в Waafir файл NDJSON с 1 200 платежами. Импорт завершился со статусом succeeded и rowCountSucceeded: 1200. Это один сигнал. Запросы сверки дают два более надёжных:

  • Выборочная проверка по ID вызывающей стороны — выберите платёж, важный для вашей команды, найдите его по собственному external_id и убедитесь, что значения совпадают с отправленными. Канонический дескриптор — ваш идентификатор, а не внутренний UUID Waafir.
  • Совокупные количества по сущностям — убедитесь, что подсчитанное Waafir количество действующих строк за день совпадает с количеством в вашем эталонном источнике. «Сегодня я отправил 1 200 платежей; по данным counts сегодня создано 1 200. Сверено».

Запросы безопасны с точки зрения кэширования (Cache-Control: private, no-store при поиске отдельного кредита), поэтому ответ отражает последнюю запись. Сверка сразу после импорта возвращает только что записанное состояние.

Два эндпоинта

  • GET /api/v1/monitoring/loan/loans/{externalId}?portfolioId=… — сверка отдельного кредита по вашему собственному external_id. Возвращает данные кредита и маскированный контекст заёмщика, чтобы без второго запроса убедиться, что кредит привязан к ожидаемому заёмщику.
  • GET /api/v1/monitoring/loan/counts?date=YYYY-MM-DD&portfolioId=…&entity=… — количества строк по сущностям. Без entity возвращает количества по всем шести сущностям кредитной области; с entity — только по указанной. Параметр date добавляет количество onDate к количеству за всё время.

Оба эндпоинта возвращают 404 для отсутствующих строк и для строк, существующих в другой организации, — Waafir никогда не подтверждает и не отрицает существование данных другого тенанта.

Рецепт

# curl — reconcile a single loan and verify per-entity counts
set -euo pipefail

PAT="${WAAFIR_PAT}"
BASE_URL="${WAAFIR_BASE_URL:-https://app.waafir.io}"
PORTFOLIO_ID="${WAAFIR_PORTFOLIO_ID}"
EXTERNAL_LOAN_ID="L-2026-05-22-1234"
TODAY="2026-05-22"

# Step 1 — single-loan reconciliation. The external_id is URL-encoded
# automatically by curl when passed as a positional path segment.
curl -fsS \
  "${BASE_URL}/api/v1/monitoring/loan/loans/${EXTERNAL_LOAN_ID}?portfolioId=${PORTFOLIO_ID}" \
  -H "Authorization: Bearer ${PAT}" \
  | jq '{loan: {externalId: .loan.externalId, principalAmount: .loan.principalAmount, status: .loan.status, disbursementDate: .loan.disbursementDate}, borrower: {externalId: .borrower.externalId, name: .borrower.name, countryCode: .borrower.countryCode}}'

# Step 2 — full per-entity counts for the portfolio.
curl -fsS \
  "${BASE_URL}/api/v1/monitoring/loan/counts?portfolioId=${PORTFOLIO_ID}&date=${TODAY}" \
  -H "Authorization: Bearer ${PAT}" \
  | jq

# Step 3 — counts for just the payments entity (narrower request).
curl -fsS \
  "${BASE_URL}/api/v1/monitoring/loan/counts?portfolioId=${PORTFOLIO_ID}&date=${TODAY}&entity=actual_payments" \
  -H "Authorization: Bearer ${PAT}" \
  | jq
// TypeScript — reconcile a single loan and verify per-entity counts
const PAT = process.env.WAAFIR_PAT!;
const BASE_URL = process.env.WAAFIR_BASE_URL ?? "https://app.waafir.io";
const portfolioId = process.env.WAAFIR_PORTFOLIO_ID!;
const externalLoanId = "L-2026-05-22-1234";
const today = "2026-05-22";

const auth = { Authorization: `Bearer ${PAT}` };

// Step 1 — single-loan reconciliation.
const loanRes = await fetch(
    `${BASE_URL}/api/v1/monitoring/loan/loans/${encodeURIComponent(externalLoanId)}?portfolioId=${portfolioId}`,
    { headers: auth },
);
if (loanRes.status === 404) throw new Error(`loan ${externalLoanId} not found in portfolio ${portfolioId}`);
if (!loanRes.ok) throw new Error(`reconcile failed: ${loanRes.status}`);
const loanBody = (await loanRes.json()) as {
    loan: { externalId: string; principalAmount: string; status: string; disbursementDate: string };
    // borrower may be null if a referential-integrity edge case dropped
    // the borrower row; the response is a partial projection in that case.
    borrower: {
        externalId: string;
        name: string;            // masked (e.g. "M*** S. L."), empty when absent
        countryCode: string | null;
    } | null;
};
console.log({
    loan: {
        externalId: loanBody.loan.externalId,
        principalAmount: loanBody.loan.principalAmount,
        status: loanBody.loan.status,
        disbursementDate: loanBody.loan.disbursementDate,
    },
    borrower: loanBody.borrower
        ? {
              externalId: loanBody.borrower.externalId,
              name: loanBody.borrower.name,
              countryCode: loanBody.borrower.countryCode,
          }
        : null,
});

// Step 2 — full per-entity counts.
const countsRes = await fetch(
    `${BASE_URL}/api/v1/monitoring/loan/counts?portfolioId=${portfolioId}&date=${today}`,
    { headers: auth },
);
console.log("counts:", await countsRes.json());

// Step 3 — narrow to a single entity.
const paymentsRes = await fetch(
    `${BASE_URL}/api/v1/monitoring/loan/counts?portfolioId=${portfolioId}&date=${today}&entity=actual_payments`,
    { headers: auth },
);
console.log("payments:", await paymentsRes.json());
# python — reconcile a single loan and verify per-entity counts
import os
import urllib.parse
import requests

PAT = os.environ["WAAFIR_PAT"]
BASE_URL = os.environ.get("WAAFIR_BASE_URL", "https://app.waafir.io")
portfolio_id = os.environ["WAAFIR_PORTFOLIO_ID"]
external_loan_id = "L-2026-05-22-1234"
today = "2026-05-22"

auth = {"Authorization": f"Bearer {PAT}"}

# Step 1 — single-loan reconciliation. external_id can contain hyphens
# and other URL-safe chars; encode defensively in case yours contain slashes.
encoded = urllib.parse.quote(external_loan_id, safe="")
loan = requests.get(
    f"{BASE_URL}/api/v1/monitoring/loan/loans/{encoded}",
    params={"portfolioId": portfolio_id},
    headers=auth,
    timeout=30,
)
if loan.status_code == 404:
    raise SystemExit(f"loan {external_loan_id} not found in portfolio {portfolio_id}")
loan.raise_for_status()
body = loan.json()
print({
    "loan": {
        "externalId": body["loan"]["externalId"],
        "principalAmount": body["loan"]["principalAmount"],
        "status": body["loan"]["status"],
        "disbursementDate": body["loan"]["disbursementDate"],
    },
    "borrower": {
        "externalId": body["borrower"]["externalId"],
        "name": body["borrower"]["name"],
        "countryCode": body["borrower"]["countryCode"],
    },
})

# Step 2 — full per-entity counts.
counts = requests.get(
    f"{BASE_URL}/api/v1/monitoring/loan/counts",
    params={"portfolioId": portfolio_id, "date": today},
    headers=auth,
    timeout=30,
).json()
print("counts:", counts)

# Step 3 — narrow to one entity.
payments = requests.get(
    f"{BASE_URL}/api/v1/monitoring/loan/counts",
    params={"portfolioId": portfolio_id, "date": today, "entity": "actual_payments"},
    headers=auth,
    timeout=30,
).json()
print("payments:", payments)

Что проверить

В ответе по отдельному кредиту каждое поле, отправленное под вашим external_id, должно вернуться без изменений: principalAmount, currencyCode, interestRateApr, disbursementDate, termMonths, repaymentFrequency, productType, status, metadata. Раздел заёмщика маскируется в соответствии с политикой Waafir в отношении PII — name, email, phone и nationalIdLast4 по умолчанию маскируются в этом эндпоинте; поля, не относящиеся к PII (countryCode, dob, gender, incomeBand, employmentStatus), передаются как есть.

В ответе с количествами итоги ограничены вашей организацией и не включают мягко удалённые строки. С ?date=YYYY-MM-DD запись каждой сущности содержит количество onDate — строк, созданных в эту дату, — наряду с итогом за всё время. Количество onDate и есть ваш сигнал соответствия отправке.

Ответ 404 от эндпоинта отдельного кредита всегда означает, что кредит не виден вашей организации в этом портфеле. Возможно, его вообще не существует, а возможно, он существует в другой организации; ответ намеренно их не различает.