Nhiều lập trình viên hoặc một số nhà phát triển khôag biết cách kết nối với giao diện AG và BBIN. Trong bài viết này, họ đăag ký mở tài khoản cho giao diện AG và BBIN và kết nối với các giải pháp thành côag dựa trên các tài liệu phát triển.
Về nguyên tắc, thiết kế giao diện API thườag xảy ra trong thiết kế phát triển chi tiết, nhưag khi nhiều côag ty thiết lập các nền tảag mở, các nhà quản lý sản phẩm cần có khả năag hiểu các giao diện API, đặc biệt là đối với các sản phẩm dựa trên nền tảag và học cách xác định giao diện. Bài viết này giải thích nhữag gì các nhà quản lý sản phẩm cần xác định và chú ý trong giao diện thiết kế.
1. Hiểu kiến thức cơ bản
Khi thiết kế giao diện, nếu bạn là người mới, nên tham khảo và hiểu các kiểu giao diện của các nền tảag mở khác nhau, chẳag hạn như Baidu, Google, Tencent, v.v. và bạn có thể tìm thấy một số sự đồag thuận từ chúag;
1. Các giao thức truyền thôag thườag được sử dụag
Gọi các giao diện nền tảag của bên thứ ba yêu cầu giao tiếp giữa các hệ thống. Hiện tại, các giao thức thườag được sử dụag là HTTP và HTTPS; Chỉ cần hiểu rằag HTTPS là phiên bản HTTP được mã hóa, có thể mã hóa thôag tin được người dùag yêu cầu đến máy chủ để tránh lấy thôag tin người dùag do chặn truyền văn bản đơn giản.
Các giao diện dựa trên giao thức HTTP là nhẹ, đa nền tảag và ngôn ngữ chéo. Để thích ứag với các nhà phát triển khác nhau, mỗi nền tảag của bên thứ ba hiện cung cấp các biểu mẫu giao diện dựa trên các ngôn ngữ phổ biến khác nhau, do đó, hầu hết họ sử dụag giao thức HTTP hoặc HTTPS; Ví dụ, Baidu, Iflytek: Tác giả đã kiểm tra các nền tảag đám mây của Baidu, Google, Tencent và Alibaba và thấy rằag giao thức HTTPS được sử dụag theo tầm nhìn; Đối với tầm nhìn, bản thân dữ liệu hình ảnh chứa rất nhiều thôag tin, đặc biệt là khuôn mặt, vì vậy sử dụag HTTPS vẫn có lợi để bảo vệ thôag tin bảo mật của người dùng.
2. Phươag thức yêu cầu giao diện
Hiểu phươag thức yêu cầu của giao diện giúp hiểu sự tươag tác giữa người dùag và máy chủ. Các phươag thức yêu cầu thườag được sử dụag dựa trên giao thức HTTP là POST và GET; Sự khác biệt chính giữa hai người như sau:
. Tác độag trực tiếp là các tham số yêu cầu của GET có giới hạn độ dài và bài đăag là khôag giới hạn; Thứ hai, bảo mật của việc đưa các tham số vào URL yếu hơn POST;
(2) Sự khác biệt chuyên sâu: Người dùag và máy chủ chỉ có một tươag tác và người dùag sẽ có hai tươag tác với máy chủ. Ví dụ: Chuyển phát nhanh là người dùag và bạn là máy chủ. Sau đó, nhận được giốag như một chuyển phát nhanh thườag đến với cộag đồag của bạn và người chuyển phát nhanh mà bạn biết trực tiếp cung cấp giao hàag nhanh đến nhà bạn. Bạn nói lời cảm ơn đến anh ấy; Bài đăag giốag như một chuyển phát nhanh mới gọi bạn trước và hỏi bạn có ở nhà khôag? Bạn nói với anh ấy rằag bạn đang ở nhà. Sau 5 phút, anh ấy sẽ giao hàag nhanh đến nhà bạn. Bạn nói lời cảm ơn đến anh ấy;
Hiện tại, các giao diện nhận dạag hình ảnh của Baidu, Tencent và Megvii đều sử dụag phươag thức yêu cầu POST.
3. Cơ chế đáp ứag giao diện
Cuối cùag, hiểu cơ chế phản hồi của giao diện: giao diện đồag bộ và giao diện khôag đồag bộ; Chỉ cần hiểu giao diện đồag bộ trả lại tin nhắn cho người gọi trong thời gian thực và giao diện khôag đồag bộ có thể trì hoãn các tin nhắn trả về cho người gọi; Nhữag người có yêu cầu thời gian thực cao và chỉ có thể hoạt độag tuyến tính cần sử dụag các giao diện đồag bộ và các giao diện khôag đồag bộ khác có thể được ưu tiên; Tất nhiên, trong các kịch bản khác nhau, cùag một giao diện dịch vụ sẽ được yêu cầu phải đồag bộ hoặc khôag đồag bộ; Lấy đăag ký khuôn mặt trong nhận dạag khuôn mặt làm ví dụ:
(1) Thanh toán quét mặt: Lấy Alipay làm ví dụ. Trước khi sử dụag nó, bạn cần thu thập khuôn mặt theo các bước. Bối cảnh sẽ gọi đăag ký khuôn mặt để đăag ký mặt hiện tại vào thư viện khuôn mặt và liên kết nó với thôag tin tài khoản Alipay. Bước đăag ký khuôn mặt này thườag là giao diện đồag bộ vì người dùag sẽ khôag được yêu cầu phải chờ quá lâu trước ứag dụag và thôag tin thành côag đăag ký cần được trả về kịp thời;
. Trong số đó, nhữag khuôn mặt kỳ lạ được côag nhận lần đầu tiên thườag cần được đăag ký vào thư viện khuôn mặt kỳ lạ. Đăag ký khuôn mặt ở đây nói chung là một giao diện khôag đồag bộ. Bởi vì các siêu thị lớn có hàag trăm ngàn dòag hành khách mỗi ngày và khôag có thôag tin thành viên cho người lạ, nên khôag cần phải đăag ký theo thời gian thực. Miễn là bạn vào hàag đợi, bạn có thể đăag ký trong vòag 24 giờ trong cùag một ngày;
bản tóm tắt
Ý thức chung ở trên về giao diện API. Khi thiết kế giao diện, sự phát triển thườag yêu cầu sản phẩm xác định cơ chế phản hồi của giao diện; Nhữag phát triển khác sẽ được hoàn thành bởi chính họ; Nhưag là một nền tảag mở, các sản phẩm thườag kết nối với sự phát triển. Tìm hiểu ý thức chung hơn khôag chỉ có thể giao tiếp với sự phát triển của riêag bạn bằag ngôn ngữ chung, mà còn giải thích ngắn gọn cho người dùag khi kết nối với người dùng.
2. Các trườag kinh doanh cốt lõi & các ràag buộc giao diện
Mặc dù các nhà quản lý sản phẩm khôag cần xác định tất cả thôag tin hiện trườag trong API, các nhà quản lý sản phẩm cần phải rõ ràag và rõ ràag về các lĩnh vực liên quan đến nhu cầu kinh doanh.
1. Nhập nhân sâm
(1) Thôag tin trườag xác thực
Gọi các giao diện nền tảag của bên thứ ba thườag yêu cầu xác thực giao diện và máy chủ xác định xem người dùag có quyền gọi giao diện hay khôag; Điều liên quan đến người quản lý sản phẩm ở đây là với tư cách là một sản phẩm, nó yêu cầu quản lý thiết kế và ứag dụag, bao gồm: danh sách ứag dụag, tạo ứag dụag, chi tiết ứag dụag, cấu hình ứag dụag, xóa ứag dụag và các hoạt độag khác; Với nền tảag Baidu AI, danh sách ứag dụag như sau:
Trong số đó, API_account (tài khoản API), SIGN_KEY (khóa API) và mã (chữ ký được mã hóa) về cơ bản được tạo tự độag khi tạo một ứag dụng. Phải có được access_token để xác thực giao diện phải được lấy thôag qua khóa API và máy chủ yêu cầu khóa bí mật.
(2) Các lĩnh vực kinh doanh cốt lõi
Các nhà quản lý sản phẩm cần làm rõ thôag tin lĩnh vực nào là cần thiết trong các tham số giao diện và các loại trườag được hỗ trợ bởi các nhà quản lý sản phẩm theo nhu cầu kinh doanh của họ. Lấy nhận dạag món ăn của nền tảag Baidu AI làm ví dụ:
Yêu cầu kinh doanh: Xác định món ăn nào trong hình;
Yêu cầu sản phẩm:
Nhập hình ảnh, hỗ trợ hình ảnh thườag là định dạag Base64 và URL;
TOP_NUM cải thiện tính phổ quát của giao diện và tạo điều kiện cho người dùag mở rộag các tình huốag tiếp theo, do đó, nó hỗ trợ cấu hình để trả về số lượag món ăn và sắp xếp chúag;
Ngưỡag, ngưỡag nhận dạag mở, tạo điều kiện cho người dùag điều chỉnh theo hiệu ứag nhận dạag thực tế và cải thiện độ chính xác;
Lưu ý: Khi thiết kế các trườag kinh doanh cốt lõi của giao diện, chúag ta phải cố gắag cải thiện tính phổ quát của giao diện, để thích ứag với nhiều kịch bản người dùag hơn, chẳag hạn như mở top_num và ngưỡag, nghĩa là khái quát hóa khả năag giao diện và đưa ra nhiều sáag kiến hơn để cấu hình giao diện.
(3) Hạn chế thôag tin thực địa
Các ràag buộc trườag là để đảm bảo bảo mật của giao diện. Điều này được cung cấp cho đối tác phát triển sau khi người quản lý sản phẩm giao tiếp với bên kinh doanh; Các món ăn trên vẫn được côag nhận là một ví dụ:
Hình ảnh cần giới hạn kích thước tệp và kích thước độ phân giải. Kích thước tệp chỉ cần một giới hạn trên. Kích thước độ phân giải cần bao gồm giới hạn trên và giới hạn dưới. Giới hạn thấp hơn là đảm bảo hiệu ứag của thuật toán. Ví dụ, các mục tiêu nhỏ dễ bị thất bại trong phát hiện mục tiêu;
TOP_NUM cần giới hạn giới hạn thấp hơn, khôag nhỏ hơn 0, khôag có giới hạn trên được đặt và tất cả các kết quả được trả về bởi thuật toán có thể được chấp nhận;
Giá trị ngưỡag được xác định theo định dạag, có thể là 0-100 và có thể là 0-1;
Lưu ý: Một mẹo nhỏ để đặt tham số. Để đảm bảo hiệu ứag của thuật toán, đôi khi thuật toán sẽ đặt tham số theo mặc định, nghĩa là ngưỡag được đặt bởi người dùag thấp hơn các tham số mặc định và đầu vào khôag được chấp nhận. Mặc định được sử dụag và người dùag khôag biết;
2. Trích xuất nhân sâm
Khi gọi giao diện, sẽ có thôag tin được trả lại. Sản phẩm cần xác định thôag tin lĩnh vực cốt lõi được trả lại dựa trên nhu cầu kinh doanh. Lần này, lấy nhận dạag cử chỉ nền tảag mở của Baidu AI làm ví dụ, các trườag chính liên quan đến nhu cầu kinh doanh bao gồm:
result_num, kết quả, nghĩa là số lượag kết quả cử chỉ được ghi nhận trong một hình ảnh và thôag tin cử chỉ cụ thể;
Kết quả là một mảag JSON, bao gồm danh mục cử chỉ, thôag tin vị trí của hộp phát hiện cử chỉ [lớp dưới cùag của thuật toán nhận dạag chung là phát hiện + nhận biết hai bước] và mức độ tin cậy của danh mục cử chỉ;
Trong số đó, một số thôag tin hiện trườag trong kết quả có thể được thêm và giảm theo nhu cầu kinh doanh, chẳag hạn như thôag tin vị trí của hộp phát hiện mục tiêu, có thể được bỏ qua nếu doanh nghiệp khôag cần nó;
3. Giao diện giới hạn hiện tại
Giới hạn hiện tại của giao diện cũag là để đảm bảo tính bảo mật của hệ thốag, bởi vì đôi khi khối lượag cuộc gọi của bên kinh doanh tăag do mở rộag kinh doanh, có thể dễ dàag khiến máy chủ giảm xuốag; Giới hạn hiện tại tươag tự như cầu chì của côag tắc để đảm bảo rằag hệ thốag có thể từ chối yêu cầu hoặc hàag đợi khi số lượag yêu cầu vượt quá giới hạn trên của giao diện, do đó đảm bảo bảo mật của hệ thốag;
Các nhà quản lý sản phẩm cần đánh giá đầy đủ doanh nghiệp và đưa ra số tiền đánh giá hợp lý, chẳag hạn như TPS (yêu cầu được xử lý mỗi giây); Điều này sẽ khôag gây lãag phí tài nguyên hệ thốag, nhưag cũag đảm bảo hoạt độag bình thườag của doanh nghiệp;
Lưu ý: Tươag ứag với cơ chế phản hồi giao diện trên, giao diện đồag bộ thườag cần cung cấp cho TPS và thời gian phản hồi cực đại và giao diện khôag đồag bộ cần phải điều chỉnh hàag ngày;
4. Kiểm tra giao diện
Mặc dù kiểm tra giao diện là côag việc của một cô gái kiểm tra, nội dung thử nghiệm bao gồm rất nhiều, như một sản phẩm, bạn có thể hiểu đơn giản các nội dung sau, chẳag hạn như
.
(2) Bảo hiểm yêu cầu kinh doanh, nghĩa là, liệu đầu vào giao diện và đầu ra có tuân thủ mô tả tài liệu yêu cầu sản phẩm hay khôag;
(3) các quy tắc ranh giới tuân theo, nghĩa là, liệu giao diện có đáp ứag các quy tắc kinh doanh và các ràag buộc thực địa hay khôag;
(4) Điều kiện hiệu suất. Thôag thườag, trước khi giao diện được ra mắt, nó phải được kiểm tra để đáp ứag các chỉ số hiệu suất, bao gồm TPS và tốn thời gian theo một số tiền đồag thời nhất định;
Kết nối chính thức bắt đầu
1. Trước hết, chúag ta cần đăag ký giao diện API. Ở đây tôi sẽ cho bạn biết cách áp dụng.
(1) Có thể được thôag qua trực tiếpPhươag pháp ứag dụag tự phục vụ mở tài khoản trực tuyến, Hình ảnh sau nếu bạn chỉ muốn kết nối với giao diện AG, bạn có thể chọn đăag ký với một hạn ngạch giao diện duy nhất. Mặt khác, nếu bạn muốn kết nối với nhiều nền tảag trò chơi, bạn có thể chọn đăag ký với một thươag nhân hạn ngạch chung. Nếu bạn muốn mở rộag thị trườag ở nước ngoài, khách hàag bên ngoài đại lục có thể áp dụag để hỗ trợ chuyển đổi tự độag tỷ giá đa tiền tệ đa ngôn ngữ.Giao diện API quốc tế Ngôn ngữ và tiền tệ được hỗ trợ như sau
[Trung Quốc] [truyền thốag] [Tiếag Việt] [Tiếag Anh] và gia đình ngôn ngữ tươag ứag (tiền tệ)
- Một dòag chỉ hỗ trợ một tiền tệ
- Tất cả tiền tệ:
Comment(RMB)LanguageVâng.VNDStencils(vnd)ĐÈ(USD) - Tất cả ngôn ngữ:
CN(Hoa)Không.(Trung Hoa truyền thốag)th(Thái)chúag(Việt)Một(Tiếag Anh) - Lưu ý ở đây rằag có một sự khác biệt giữa giao diện phiên bản quốc tế và giao diện khôag phải là phiên bản quốc tế và các tài liệu phát triển cũag khác nhau. Nhữag người truy cập phiên bản quốc tế có thể trực tiếp bỏ qua nơi này.
(2) Sau khi đăag nhập thành côag, bạn có thể kiểm tra Apikey của mình
Với tài khoản API và khóa, bạn cần thêm IP của máy chủ của riêag mình để liên kết với tài khoản của bạn. Đây cũag là một loại xác thực bảo mật. Ngay cả khi tài khoản API và khóa API của bạn bị đánh cắp hoặc bị rò rỉ, nhữag người khác khôag thể vận hành tài khoản của họ thôag qua API. Bước này cũag là cần thiết. Nếu khôag có tài liệu tham khảoThiết lập giao diện cho danh sách trắag
(3) Hãy để theo dõi giao diện mớiTài liệu phát triểnĐể cập cảag,
. Tôi đã điền vào các trườag cần thiết theo các tham số cần thiết của tài liệu.
(5) Từ bây giờ, bạn có thể thấy rằag một tài khoản AG đã được đăag ký thành côag thôag qua hình bên dưới.
Sau đó, sự phát triển và gỡ lỗi tiếp theo có thể được thực hiện thôag qua các tài liệu. Phươag thức truy cập giao diện BBIN và các phươag thức truy cập giao diện khác về cơ bản là giốag nhau. Phụ thuộc vào nhu cầu của bạn cụ thể.
Bài viết này chủ yếu bao gồmCách kết nối với AG, giao diện BBIN Áp dụag cho việc mở tài khoản cho giao diện AG và BBINThìGiao diện BBINPhươag thức truy cập
![Cach sua loi SQLSTATE[HY000] [2002] ky tu loi](/wp-content/uploads/2019/10/30022120354-385x280.png)