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ở.
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.
Kết nối trợ lý của bạn
Sáu kỹ năng và năm công cụ MCP hỗ trợ nghiên cứu, lập kế hoạch tích hợp và bản nháp có thể xem xét.
02Kiểm tra kết quả tổng hợp
Bài tập khớp, không khớp, thiếu bằng chứng, hết thời gian và tuyến dịch vụ không được hỗ trợ.
03Xem lại hợp đồng API
Kết nối quy trình làm việc đã được xem xét với hợp đồng API Quyết định và phạm vi truy cập nhà cung cấp được ủy quyền.
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ờ
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.