HACS
KOENVILO
Cổng tổ chứcLiên hệ

Developers

Từ cấp khóa
đến điểm số đầu tiên

Đăng ký đối tác → cấp khóa → tra cứu đầu tiên trên sandbox → chuyển sang môi trường thật. REST chuẩn, phản hồi có chữ ký, webhook tự động thử lại, SDK cho 4 ngôn ngữ.

Tài liệu FI APISwagger UIVerifier SDK

Quickstart

Tích hợp chỉ trong bốn bước

  1. Đăng ký đối tác · cấp khóa

    Nhận Client ID và API key trên cổng đối tác. Khóa sandbox do bạn tự cấp.

  2. Kiểm tra bằng whoami

    Kiểm tra khóa và scope bằng GET /fi/whoami.

  3. Tra cứu điểm đầu tiên trên sandbox

    Nhận trước phản hồi theo từng hạng với chủ thể thử nghiệm cố định và các ca kiểm thử cố định.

  4. Chuyển sang môi trường thật

    Vượt qua danh sách kiểm tra là kết nối vào môi trường vận hành với cùng một đoạn mã.

5-minute integration

Chỉ một lần gọi

# Consent-gated soft-pull score (deny-by-default)
curl -X POST https://trendy.storydot.kr/superapp/api/fi/score/query \
  -H "X-Client-Id: $CLIENT_ID" -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pairwiseSub":"pairwise-subject-id","purpose":"LOAN_UNDERWRITING"}'
# → { success, data: { score, tier, reasonCodes[…] } } · every query is audit-logged

Partner API

Các endpoint cốt lõi

URL gốc https://trendy.storydot.kr/superapp/api · xác thực qua header X-Client-Id + X-API-Key · 60 lượt mỗi phút.

Phương thứcĐường dẫnMô tả
POST/fi/score/queryTra cứu điểm dựa trên sự đồng ý — điểm số · hạng · mã lý do
POST/fi/decision/evaluateĐánh giá quyết định theo tiêu chí cấp tín dụng
POST/fi/score/batchTra cứu theo lô 1~100 hồ sơ
POST/fi/verifyXác minh chứng nhận được xuất trình
POST/api/v1/fi/proof/verifyXác minh bằng chứng không tiết lộ về hạng tín dụng (scope proof:verify)
GET/fi/score/historyLịch sử điểm số, tối đa 365 ngày
POST/fi/consent/requestsTạo yêu cầu đồng ý
GET/fi/consent/{id}Tra cứu trạng thái đồng ý
GET/fi/usageLượng sử dụng, tối đa 92 ngày
GET/fi/whoami · /fi/healthKiểm tra khóa · kiểm tra trạng thái

Built for production

Thiết kế cho vận hành thực tế

Webhooks

Có chữ ký và tự động thử lại

4 loại sự kiện. Chữ ký HMAC-SHA256 trong X-HACS-Signature; khi thất bại sẽ thử lại sau 1 phút · 5 phút · 30 phút · 2 giờ.

Sandbox

Môi trường thử nghiệm tất định

Chủ thể thử nghiệm cố định, ca kiểm thử cố định và phản hồi theo từng hạng giúp thử trước cả các điều kiện biên.

Recipes

Công thức ngưỡng hạng

Cung cấp các ngưỡng hạng 750 / 650 / 550 / 450, bảng tham chiếu điều kiện cấp tín dụng theo nhóm rủi ro và ví dụ luồng thẩm định.

Errors

Phân biệt mã lý do và lỗi

Bảng mã lỗi tách bạch rõ lỗi cần thử lại với lý do của quyết định, cùng quy tắc mã trạng thái HTTP.

Issuers

API cho tổ chức cấp phát

Đăng ký → thẩm định → phê duyệt → cấp phát dưới danh nghĩa tổ chức. Kênh cấp phát đóng lại khi thất bại (fail-closed).

Compliance

Mọi quyết định đều có thể kiểm toán

Kiểm soát sự đồng ý, nhật ký truy cập dạng chuỗi băm, quản trị mô hình, nguồn gốc quyết định, tối thiểu hóa định danh.

SDKs

Đúng ngôn ngữ bạn đang dùng

Ngôn ngữGóiPhiên bản
TypeScript · JavaScript@superwallet/verifier-sdk (npm)2.3.0
TypeScript · ZK@superwallet/zk-kit (npm) — 21 ID mạch vận hành0.2.0
Java 17com.superwallet (Gradle)1.1.0
Pythonsuperwallet-verifier1.1.0
PHP 8.1+superwallet/verifier-sdk (Composer)—

Documentation

Truy cập nhanh tài liệu

FI API

Tài liệu cho nhà phát triển

Tổng quan · bắt đầu nhanh · xác thực · tham chiếu · sandbox · lỗi · webhook · đồng ý · eID · tổ chức cấp phát · tuân thủ · công thức

 OpenAPI

Swagger UI

Gọi thử ngay trên trình duyệt toàn bộ các thao tác của API đối tác.

 Verifier

Verifier SDK · Demo

Widget chứng minh điều kiện, relay, xác minh trực tiếp trên chuỗi.

 LLM

llms.txt

Tài liệu tóm tắt mà AI agent có thể đọc được.

Nhận khóa sandbox ngay hôm nay

Đăng ký làm đối tácTài liệu bắt đầu nhanh