Chuyển đến nội dung chính
Rock API xử lý thông tin xác thực API và nội dung yêu cầu để xác thực, định tuyến và tính phí các lượt gọi mô hình. Cổng API chuyển nội dung đến dịch vụ thượng nguồn để suy luận. Trước khi gửi dữ liệu nhạy cảm, hãy xem xét cách cổng API xử lý dữ liệu và điều khoản áp dụng cho tuyến thượng nguồn thực sự được sử dụng. Trang này mô tả hành vi đã được kiểm chứng trong mã triển khai và các việc bạn có thể thực hiện. Cấu hình môi trường vận hành, lịch lưu giữ dữ liệu và hợp đồng với nhà cung cấp thượng nguồn cần được xác nhận riêng; chỉ mã nguồn không đủ để xác lập các chính sách đó.

Dữ liệu yêu cầu đi đâu

  1. Ứng dụng gửi khóa API và yêu cầu đến địa chỉ HTTPS https://rockapi.ai/v1. Hãy thực hiện lệnh gọi ở máy chủ; xem Xác thực.
  2. Cổng API kiểm tra khóa và tài khoản, áp dụng các giới hạn đã cấu hình rồi chọn kênh thượng nguồn. Tùy điểm cuối và cấu hình kênh, cổng có thể ánh xạ tên mô hình, chuyển đổi định dạng, ghi đè tham số hoặc chuyển tiếp trực tiếp phần thân yêu cầu.
  3. Dịch vụ thượng nguồn nhận nội dung cần cho suy luận, gồm tin nhắn, đầu vào công cụ, dữ liệu đa phương tiện hoặc tham chiếu đến chúng. Cổng xử lý phản hồi và thông tin sử dụng rồi trả kết quả về ứng dụng khách.
  4. Nhật ký sử dụng và lỗi phục vụ tính phí và xử lý sự cố. Tác vụ đa phương tiện bất đồng bộ cũng có thể lưu đầu vào, trạng thái, dữ liệu nhà cung cấp và URL kết quả. Bản ghi của chúng khác nhật ký yêu cầu văn bản.
Chuyển tiếp trực tiếp không phải là ẩn danh hóa. Bộ điều hợp thượng nguồn tiêu chuẩn dùng thông tin xác thực được cấu hình cho kênh. Quy tắc chuyển tiếp tiêu đề theo ký tự đại diện hoặc biểu thức chính quy loại trừ cookie và các tiêu đề xác thực phổ biến, nhưng cấu hình ghi đè tiêu đề cụ thể có thể thay đổi hành vi này. Không đặt bí mật hoặc thông tin định danh cá nhân trong tiêu đề tùy chỉnh.

Bảo vệ và thu hồi khóa API

Tạo khóa API riêng cho từng ứng dụng và môi trường. Nếu trình chỉnh sửa khóa có các tùy chọn tương ứng, hãy đặt thời hạn, hạn mức hữu hạn, mô hình được phép và danh sách IP cho phép. Trước khi chuyển yêu cầu đến mô hình, mã triển khai kiểm tra trạng thái khóa, thời hạn, hạn mức còn lại và giới hạn IP đã cấu hình; giới hạn mô hình ràng buộc việc định tuyến. Kiểm tra danh sách IP từ địa chỉ IP đầu ra thực tế của ứng dụng. Lưu khóa trong hệ thống quản lý bí mật phía máy chủ hoặc cấu hình chạy được bảo vệ. Không đưa khóa vào gói mã trình duyệt, ứng dụng di động, kho mã, URL, ảnh chụp màn hình hay bản ghi yêu cầu được chia sẻ. Ưu tiên tiêu đề xác thực được tài liệu hướng dẫn thay vì tham số truy vấn URL. Phản hồi danh sách và chi tiết che bớt giá trị khóa, còn một thao tác riêng có xác thực có thể lấy giá trị đầy đủ. Che khóa là biện pháp hiển thị; điều đó không chứng minh khóa được băm một chiều hoặc mã hóa khi lưu trữ. Khi luân chuyển định kỳ, tạo khóa thay thế, cập nhật ứng dụng, kiểm tra một lệnh gọi rồi vô hiệu hóa hoặc xóa khóa cũ. Nếu khóa bị lộ, hãy vô hiệu hóa hoặc xóa khóa đó trước, thay khóa và kiểm tra nhật ký sử dụng để tìm lượt gọi bất thường. Xác nhận khóa cũ bị từ chối; liên hệ hỗ trợ nếu khóa vẫn dùng được. Thu hồi khóa không xóa bản ghi lịch sử.

Nhật ký có thể chứa gì

Việc ghi nhật ký tiêu thụ và tổng hợp mức sử dụng có thể được cấu hình. Chế độ xem dành cho người dùng loại bỏ một số chi tiết quản trị, nên giao diện không liệt kê mọi trường đã lưu. Tắt một loại nhật ký hoặc tùy chọn IP không tắt toàn bộ bản ghi truy cập, bảo mật, tác vụ hay hạ tầng. Xem Giá và thanh toán để đối chiếu mức tiêu thụ.

Giảm lượng thông tin gửi đi

Chỉ gửi các lượt hội thoại, trích đoạn tài liệu, kết quả công cụ và dữ liệu đa phương tiện cần cho tác vụ. Loại bỏ mật khẩu, token truy cập, dữ liệu thanh toán và thông tin cá nhân không liên quan. Thay danh tính khách hàng bằng mã nội bộ và giữ bảng ánh xạ trong hệ thống của bạn. Kiểm tra cả tên tệp, siêu dữ liệu đa phương tiện, tiêu đề tùy chỉnh và URL có chữ ký bên cạnh nội dung lời nhắc. Dùng dữ liệu giả lập khi kiểm tra một tích hợp mới. Khi nhờ hỗ trợ, trước hết cung cấp mã yêu cầu hoặc tác vụ, thời gian kèm múi giờ, mã mô hình, đường dẫn điểm cuối, trạng thái HTTP và nhãn khóa. Nếu cần, bổ sung đoạn lỗi ngắn đã che thông tin nhạy cảm hoặc ví dụ tái hiện tối thiểu. Không gửi khóa API đầy đủ, tiêu đề xác thực, hội thoại riêng tư hoặc URL đa phương tiện có chữ ký chưa được che thông tin nhạy cảm.

Lưu giữ, sử dụng để huấn luyện và tuân thủ

Mã triển khai xác nhận các khả năng xử lý và ghi nhật ký. Nó không xác lập chính sách không lưu giữ, cam kết không dùng để huấn luyện hay thời hạn xóa cố định cho Rock API và tất cả dịch vụ thượng nguồn. Trước khi dùng dữ liệu nhạy cảm, liên hệ hỗ trợ qua trang Giới thiệu trên website chính để xác nhận:
  • Lưu giữ và truy cập: Những phần thân yêu cầu, đầu ra, tệp tác vụ, nhật ký sử dụng, nhật ký truy cập và bản sao lưu nào được giữ lại? Trong bao lâu, ai có quyền truy cập và có ngoại lệ nào?
  • Huấn luyện và mục đích khác: Rock API hoặc nhà cung cấp thực sự xử lý yêu cầu có dùng đầu vào, đầu ra để huấn luyện mô hình, đánh giá, kiểm tra hành vi lạm dụng hay mục đích khác không? Những điều khoản loại trừ hoặc tùy chọn từ chối nào áp dụng cho tài khoản và tuyến của bạn?
  • Thượng nguồn và vị trí: Những bên xử lý và khu vực nào phục vụ mô hình đã chọn, bao gồm lần thử lại hoặc tuyến dự phòng? Có thể bắt buộc giới hạn khu vực xử lý cho khối lượng công việc của bạn không?
  • Bằng chứng hợp đồng: Có thỏa thuận xử lý dữ liệu (DPA) không? Biện pháp bảo vệ khi chuyển dữ liệu, chứng nhận bảo mật và báo cáo kiểm toán áp dụng cho phạm vi nào của dịch vụ đã ký kết?
Hãy nhận xác nhận cho đúng mô hình, tuyến, tài khoản và loại dữ liệu trước khi tiếp tục. Chỉ tên mô hình không đủ để xác định các điều khoản này.

Yêu cầu xóa tài khoản hoặc dữ liệu

Dừng tích hợp liên quan và thu hồi khóa khi cần chấm dứt truy cập. Thao tác xóa tài khoản sử dụng cơ chế xóa mềm; điều này không chứng minh nhật ký, bản sao lưu, đầu ra tác vụ hoặc bản sao do thượng nguồn giữ đã bị xóa. Dùng kênh hỗ trợ trên trang Giới thiệu để yêu cầu xóa hoặc rà soát quyền riêng tư. Cung cấp mã tài khoản, loại dữ liệu, khoảng thời gian, mã yêu cầu hoặc tác vụ liên quan, và cho biết yêu cầu có bao gồm bản sao thượng nguồn không. Đề nghị hỗ trợ xác nhận thủ tục xác minh, phạm vi xóa, thời hạn hoàn tất, cách xử lý bản sao lưu và dữ liệu phải lưu theo luật. Chỉ gửi bằng chứng danh tính bổ sung qua kênh do hỗ trợ chỉ định.