@putin007/att-captcha-sdk-react

@putin007/att-captcha-sdk-react

Cài đặt

Ứng dụng client cần cài React 18 và go-captcha-react.

Public API

• useFrontendSdk(source)
• FrontendSdkProvider
• useFrontendSdkContext()
• GoCaptchaPuzzleWidget

Package React hiện re-export toàn bộ API của SDK core, vì vậy app client chỉ cần import từ @putin007/att-captcha-sdk-react.

Ví dụ

import { initAttCapchaSdk, GoCaptchaPuzzleWidget } from '@putin007/att-captcha-sdk-react'

const sdk = initAttCapchaSdk({
  mode: 'puzzle',
  type: 'rotate_basic',
  actionType: 'checkout_submit',
})

export function CaptchaPanel() {
  return <GoCaptchaPuzzleWidget instance={sdk} config={{ width: 300, height: 220, size: 220 }} />
}

GoCaptchaPuzzleWidget gọi sdk.verify(...) ở bên trong và đi theo direct verify mặc định. Sau khi captcha hợp lệ, backend Go sẽ trả proof token qua /api/captcha/verify.

Core SDK hiện cũng tự điền metadata.actionType từ challenge đang chạy hoặc loại captcha đã cấu hình nếu bạn chưa truyền giá trị này. Cơ chế đó giữ tương thích cho các flow cũ, nhưng với client production bạn vẫn nên truyền business action tường minh như login, register hoặc checkout_submit.