Pháp điển · III

Khóa API

Các khóa API cho phép bạn gọi các điểm cuối thanh toán và trạng thái từ mã của riêng bạn, mà không cần nút mua. Bạn chỉ cần một nếu bạn đang xây dựng thanh toán của riêng bạn hoặc tích hợp máy chủ; nếu bạn dán nút mua, bạn có thể hoàn toàn bỏ qua nó.

Khi bạn cần một chìa khóa

Nút mua hoạt động mà không có chìa khóa nào cả — nó nói chuyện với công cộng, điểm cuối có phạm vi dự án. Một chìa khóa dành cho con đường khác: các cuộc gọi bạn thực hiện từ máy chủ của riêng bạn, nơi bạn tạo thanh toán hoặc đọc trạng thái giao dịch trong mã. Khóa nằm dưới tab Khóa API của dự án của bạn.

Tab Khóa API. Trống cho đến khi bạn tạo khóa đầu tiên của bạn.

Tạo một chìa khóa

Nhấp Tạo khóa, đặt tên cho nó bạn sẽ nhận ra sau — thường là nơi nó chạy, như "Production server" — và nhấp Tạo khóa. Tên chỉ là một nhãn cho bạn; nó không thay đổi những gì chìa khóa có thể làm (một chìa khóa được bao gồm trong dự án này).

Đặt tên khóa cho nơi nó sẽ sống, sau đó tạo nó.

Sao chép nó một lần

Chìa khóa được hiển thị một lần, ngay sau khi bạn tạo nó. Nó bắt đầu với cmk_. Sao chép nó bây giờ và lưu trữ nó ở một nơi an toàn — chúng tôi chỉ giữ một hash, vì vậy chúng tôi không thể hiển thị nó cho bạn lần nữa. Mất nó và bạn đơn giản là tạo một cái mới và xóa cái cũ.

Đây là lần duy nhất khóa đầy đủ được hiển thị. Sao chép nó trước khi bạn đóng.

Coi chìa khóa như một mật khẩu. Sử dụng nó chỉ từ mã phía máy chủ, gửi nó trong tiêu đề Ủy quyền như một mã thông báo mang theo, và không bao giờ đặt nó trên một trang web, một kho công cộng, hoặc bất cứ thứ gì được gửi đến trình duyệt của người mua. Bất cứ ai có chìa khóa đều có thể hành động cho dự án của bạn.

Sử dụng, liệt kê và thu hồi

Các khóa được lưu được liệt kê theo tên, tiền tố bị che mắt và ngày tạo. Bạn không bao giờ thấy toàn bộ chìa khóa lại — tiền tố chỉ đủ để phân biệt chúng. Biểu tượng rác thu hồi chìa khóa ngay lập tức: bất kỳ mã nào vẫn sử dụng nó bắt đầu bị từ chối, vì vậy xoay vòng bằng cách tạo khóa mới trước, triển khai nó, sau đó xóa khóa cũ.

Mỗi khóa hiển thị một tiền tố bị che mắt và ngày tạo; biểu tượng rác thu hồi nó.

Đối với những gì bạn có thể gọi với chìa khóa — tạo thanh toán từ mã của riêng bạn, xử lý sự kiện và trạng thái thăm dò — xem Sử dụng API.

Sẵn sàng kết nối?

Gói miễn phí bao trọn hầu hết các trang và không bao giờ đòi thẻ.