Trường Hợp Sử Dụng

Kiểm thử CAPTCHA cho hàng đợi và checkout nền tảng bán vé trong staging

Phạm vi an toàn: Hướng dẫn này chỉ áp dụng cho môi trường QA, staging hoặc pre-production thuộc sở hữu hoặc được uỷ quyền của bạn. Nội dung bao gồm các mẫu chẩn đoán, kiểm thử và quan sát cho tích hợp CAPTCHA của chính bạn — không áp dụng cho bên thứ ba hoặc luồng không được phép.

Nền tảng bán vé thuộc sở hữu của bạn cần kiểm thử QA thực tế cho hàng đợi và checkout trước khi mở bán. Hướng dẫn này trình bày cách kiểm thử tích hợp CAPTCHA trong staging với sự kiện giả lập, ghế thử nghiệm và thanh toán mô phỏng — không can thiệp vào hàng đợi staging nội bộ hay nền tảng bên thứ ba.

Phạm vi an toàn

  • Chỉ áp dụng cho nền tảng bán vé thuộc sở hữu hoặc được uỷ quyền.
  • Sự kiện giả lập, ghế thử nghiệm, vé giả lập, token thanh toán thử nghiệm.
  • Xác thực hàng đợi nội bộ và endpoint QA.
  • Không có hàng đợi staging nội bộ, không mua vé thật.
  • Không có nền tảng bán vé bên thứ ba.

Mô hình hàng đợi nội bộ cho QA

Sao chép kiến trúc hàng đợi: người dùng QA vào hàng đợi giả lập tại https://staging.example.com/ticketing/queue-test, nhận một vị trí và khi slot mở sẽ được điều hướng tới https://staging.example.com/ticketing/checkout-test.

Sự kiện, ghế và thanh toán giả lập

FAKE_EVENT = {
    'id': 'evt_qa_001',
    'url': 'https://staging.example.com/ticketing/fake-event',
    'seats': [{'row': 'A', 'col': i, 'price_cents': 5000} for i in range(1, 21)],
}
FAKE_PAYMENT = {'token': 'qa_pm_token_demo'}

Gửi tác vụ CaptchaAI từ staging

import os, time, requests
API_KEY = os.environ['CAPTCHAAI_API_KEY']

def solve_recaptcha_v2(sitekey, pageurl):
    r = requests.post('https://ocr.captchaai.com/in.php', data={
        'key': API_KEY, 'method': 'userrecaptcha',
        'googlekey': sitekey, 'pageurl': pageurl, 'json': 1,
    }).json()
    tid = r['request']
    while True:
        time.sleep(5)
        rr = requests.get('https://ocr.captchaai.com/res.php', params={
            'key': API_KEY, 'action': 'get', 'id': tid, 'json': 1,
        }).json()
        if rr['status'] == 1:
            return rr['request']

Xác thực kết quả tại backend QA

Gửi token tới endpoint đơn hàng vé QA nội bộ. Backend xác thực token CAPTCHA, khoá ghế giả lập và trả về order_id mô phỏng. Không có vé thật nào được xử lý.

Logging và quyết định pass/fail

Test được coi là pass khi: token được backend chấp nhận, ghế giả lập được khoá và độ trễ end-to-end nằm dưới ngưỡng nội bộ. Ghi đầy đủ giá trị theo qa_case.

Khắc phục sự cố

Vấn đề Nguyên nhân thường gặp Cách xử lý
Test không tìm thấy widget Thay đổi selector hoặc thời điểm load Kiểm tra selector và wait_for_selector trên staging
CaptchaAI trả ERROR_NO_SLOT_AVAILABLE Hàng đợi đầy tạm thời Thử lại với backoff trong pipeline nội bộ
Backend QA từ chối token Sai action/sitekey/secret Đối chiếu cấu hình backend với staging

Khả năng quan sát

Hãy ghi nhật ký có cấu trúc cho mỗi lần chạy QA. Các chỉ số nên thu thập bao gồm: tổng thời gian lấy token, mã trạng thái HTTP, ID tác vụ và độ sâu hàng đợi. Tách các môi trường (development, staging, pre-production) thành các kênh riêng biệt và liên kết các bước thông qua một correlation id (ví dụ với OpenTelemetry). Khả năng phát lại toàn bộ kịch bản từ một id duy nhất sẽ cắt giảm thời gian chẩn đoán sự cố ít nhất một nửa.

Danh mục kiểm tra

  • Phạm vi kiểm thử chỉ giới hạn trong ứng dụng của bạn hoặc tài nguyên đã được uỷ quyền.
  • Khoá CaptchaAI nằm trong CI secret hoặc vault, không nằm trong mã nguồn.
  • Mỗi lần chạy có thời gian gọi và mã trạng thái phản hồi được ghi lại.
  • Có chính sách thử lại idempotent với giới hạn cho lỗi tạm thời.
  • Bài kiểm thử có thể tái lập trên CI mà không cần can thiệp thủ công.

Ví dụ gọi QA

Đoạn mã Python dưới đây minh hoạ luồng tối thiểu để kiểm thử một CAPTCHA widget trên môi trường staging của bạn thông qua CaptchaAI.

import os
import requests

API_KEY = os.environ['CAPTCHAAI_KEY']
QA_PAGE_URL = os.environ['QA_PAGE_URL']  # ví dụ https://staging.example.com/qa-login
QA_SITE_KEY = os.environ['QA_SITE_KEY']


def submit_qa_recaptcha() -> str:
    payload = {
        'clientKey': API_KEY,
        'task': {
            'type': 'NoCaptchaTaskProxyless',
            'websiteURL': QA_PAGE_URL,
            'websiteKey': QA_SITE_KEY,
        },
    }
    response = requests.post(
        'https://api.captchaai.com/createTask',
        json=payload,
        timeout=30,
    )
    response.raise_for_status()
    return response.json()['taskId']


def fetch_qa_result(task_id: str) -> dict:
    payload = {'clientKey': API_KEY, 'taskId': task_id}
    response = requests.post(
        'https://api.captchaai.com/getTaskResult',
        json=payload,
        timeout=30,
    )
    response.raise_for_status()
    return response.json()

Câu hỏi thường gặp

Quy trình này có chạm vào lưu lượng production không?

Không. Mọi ví dụ giả định một môi trường được uỷ quyền như staging.example.com hoặc một domain QA do bạn sở hữu. Hãy tái tạo cấu hình CAPTCHA của production trong bản sao staging của riêng bạn.

Có thể đặt API key trực tiếp trong mã không?

Không. Hãy nạp khoá thông qua trình quản lý secret của CI, biến môi trường hoặc vault. Khoá đã bị commit vào kho mã phải được xoay vòng ngay lập tức.

Bạn khuyến nghị gì cho lỗi tạm thời?

Thử lại idempotent kèm exponential backoff (ví dụ 1s, 2s, 4s) và một giới hạn trên. Lỗi mạng, mã 5xx và ERROR_NO_SLOT_AVAILABLE đều phù hợp để thử lại; lỗi xác thực kéo dài thì không nên.

Hướng dẫn liên quan an toàn

Xác thực tích hợp CAPTCHA của bạn trong môi trường nội bộ với CaptchaAI.

Os comentários estão desativados para este artigo.