GridZen · Đã xem xét 2026-10-09

Hướng dẫn nhanh API Quyết định: phát triển cục bộ

Chạy một yêu cầu thanh toán cục bộ để kiểm tra hợp đồng sự kiện và chính sách khởi động của GridZen. Ví dụ sử dụng dữ liệu giả lập và cơ sở cục bộ, không thực hiện các cuộc gọi bên ngoài. Một sự không khớp quốc gia trả về kết quả xem xét với điểm số 55 cho ví dụ thanh toán này; đây là kết quả chính sách phát triển, không phải dự đoán gian lận.

Chạy dịch vụ cục bộ

Sử dụng Python 3.10 trở lên, cài đặt requirements.txt trong một môi trường ảo và chạy uvicorn app.main:app --reload. Gửi ví dụ đến localhost:8000. Xác thực phát triển phụ thuộc vào cấu hình cục bộ của bạn; khi một khóa quyết định được cấu hình, hãy bao gồm X-API-Key. Đừng gửi ví dụ phát triển này đến một điểm cuối công khai hoặc thí điểm chưa được phê duyệt.

Đọc kết quả

Yêu cầu khai báo MX và ID expected_country. local-baseline phát ra identifier_present=true và country_context_match=false. Chính sách khởi động thêm 45 cho sự không khớp và thêm 10 khác cho một khoản thanh toán có điểm số không bằng không. Nó trả về xem xét, risk_score=55 và country_context_mismatch. ID dấu vết và dấu thời gian thay đổi trên mỗi đánh giá.

Bước tích hợp tiếp theo

Sử dụng tham chiếu phản hồi để xử lý các quyết định chính sách riêng biệt với các lỗi HTTP. Đối với các tín hiệu thực, hãy xác định phạm vi một bộ điều hợp được phê duyệt, thông tin xác thực và dữ liệu được phép với nhóm thí điểm. Tài liệu công khai không cấp khóa API sản xuất hoặc ngụ ý một sandbox trực tiếp mở.

GridZen dành cho nhà phát triển

Xây dựng và kiểm tra quy trình ra quyết định của bạn

Chuyển từ hợp đồng API quyết định sang một nguyên mẫu được hướng dẫn bởi trợ lý, sau đó xem xét kết quả tổng hợp trước khi xác định phạm vi một đánh giá được ủy quyền.

Các công cụ công khai cung cấp nghiên cứu và kiểm tra tổng hợp. Đánh giá thực tế yêu cầu truy cập nhà cung cấp được phê duyệt riêng biệt.

Ví dụ tổng hợp có thể thực thi

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/uvicorn app.main:app --reload

# In another terminal:
curl http://localhost:8000/api/v1/decisions/payout \
  -H "Content-Type: application/json" \
  -d '{
  "event": "payout",
  "subject": {
    "email": "person@example.com"
  },
  "context": {
    "country": "MX",
    "expected_country": "ID",
    "consent_reference": "synthetic-test-1"
  },
  "providers": [
    "local-baseline"
  ]
}'

Các trường phản hồi được chọn; ID dấu vết, dấu thời gian, bằng chứng và ghi chú kiểm toán bị bỏ qua ở đây.

{
  "event": "payout",
  "decision": "review",
  "risk_score": 55,
  "reason_codes": [
    "country_context_mismatch"
  ],
  "providers_used": [
    "local-baseline"
  ]
}

Thử GridZen ngay bây giờ

Thử miễn phí mà không cần tài khoản Hướng dẫn tích hợp

Nguồn và phạm vi

Dựa trên hợp đồng alpha và triển khai nguồn. Tính khả dụng của tuyến dịch vụ trực tiếp yêu cầu xác nhận riêng.

Tiếp tục đọc