Cách liên kết dịch vụ nhà cung cấp với thẻ bảng SMM qua API
Tại sao cần tách danh mục nhà cung cấp khỏi gian hàng của bảng
API của nhà cung cấp thường trả về danh mục kỹ thuật: ID bên ngoài, tên, giá, giới hạn, trạng thái và tham số đặt hàng. Trong bảng SMM, cùng một mục phải nằm trong cấu trúc dễ hiểu với khách hàng: nền tảng, loại quảng bá, khu vực địa lý, định dạng liên kết, chất lượng đối tượng hoặc tốc độ khởi chạy.
Nếu xuất danh mục bên ngoài mà không xử lý, gian hàng sẽ xuất hiện tên kỹ thuật, trùng lặp và các mục không khả dụng. Việc ánh xạ tách biệt logic mua hàng và thẻ dành cho khách hàng. Một dịch vụ của nhà cung cấp không nhất thiết phải là một dịch vụ riêng trong bảng.
Những dữ liệu nào cần lấy qua API
Hãy lưu dữ liệu gốc của nhà cung cấp tách biệt với cài đặt gian hàng. Không thể thay thế ID bên ngoài bằng mã định danh nội bộ của bảng: nó cần thiết để tạo đơn hàng, nhận trạng thái, hủy và phân tích lỗi. Cũng nên lưu thời gian đồng bộ lần cuối và toàn bộ phản hồi API hoặc bản chụp của nó.
- Mã định danh nhà cung cấp và ID bên ngoài của dịch vụ.
- Tên, mô tả và danh mục bên ngoài.
- Giá mua, tiền tệ và đơn vị tính.
- Khối lượng tối thiểu, tối đa và bước số lượng.
- Trạng thái khả dụng, số dư và dấu hiệu tạm dừng.
- Yêu cầu về liên kết, đăng nhập, bài đăng, bình luận và khu vực địa lý.
- Dấu hiệu khởi chạy thủ công, hủy, khởi chạy bổ sung và thực hiện một phần.
Nhược điểm của việc nhập tự động là các nhà cung cấp đặt tên khác nhau cho cùng một trường và đôi khi truyền dữ liệu không đầy đủ. Tên dịch vụ không phù hợp để liên kết ổn định: nó có thể bị thay đổi mà không đổi ID bên ngoài.
Ví dụ về yêu cầu và phản hồi danh mục dịch vụ
Định dạng API phụ thuộc vào nhà cung cấp, nhưng logic thường giống nhau: bảng truyền khóa truy cập và tham số trang, rồi nhận về một mảng dịch vụ trong phản hồi. Ví dụ, yêu cầu danh mục với con trỏ có thể trông như sau:
GET /api/services?cursor=eyJwYWdlIjoyfQ
Phản hồi API có điều kiện:
{ "services": [ { "id": "SP-1042", "name": "Global Followers", "platform": "twitch", "type": "followers", "price": "12.50", "min": 100, "max": 10000, "status": "active" } ], "next_cursor": "eyJwYWdlIjozfQ" }
Không nên ghi ngay các trường phản hồi vào thẻ gian hàng. Trước tiên cần kiểm tra chúng, lưu vào danh mục nhà cung cấp và ánh xạ với các quy tắc nội bộ. Nhược điểm của việc chỉ làm việc với thẻ đã hoàn thiện là quá trình nhập có thể ghi đè tên khách hàng, mô tả hoặc danh mục được chọn thủ công.
Trước tiên hãy thiết lập cấu trúc danh mục trong bảng
Trước khi nhập, hãy xác định phân loại của bảng. Cấp trên cùng thường mô tả nền tảng, cấp tiếp theo là hành động: người đăng ký, lượt xem, phản ứng, bình luận, người xem buổi phát trực tiếp hoặc định dạng khác. Bên trong có thể phân chia dịch vụ theo khu vực địa lý, loại đối tượng, tốc độ và điều kiện bồi hoàn.
Với mỗi danh mục, hãy đặt các dấu hiệu bắt buộc. Đối với lượt xem, đó có thể là loại liên kết và định dạng nội dung; đối với người đăng ký — nền tảng, khu vực địa lý và loại hồ sơ được phép. Nhược điểm của cấu trúc quá chi tiết là danh mục trở nên khó duy trì hơn, và các dịch vụ gần giống nhau bắt đầu chỉ khác biệt ở những chi tiết nội bộ.
Lưu liên kết giữa nhà cung cấp và gian hàng riêng biệt
Liên kết giữa dịch vụ của nhà cung cấp và thẻ của bảng phải được lưu trong một bảng hoặc thực thể riêng. Trong đó cần có nhà cung cấp, ID bên ngoài, thẻ nội bộ, danh mục, quy tắc giá, ưu tiên tuyến, trạng thái xuất bản và ngày kiểm tra thành công lần cuối.
Sơ đồ như vậy cho phép thay thế nhà cung cấp mà không đổi URL của thẻ và không mất lịch sử đơn hàng. Ví dụ về một dòng ánh xạ trong JSON:
{ "supplier_id": "supplier_a", "external_service_id": "SP-1042", "panel_category": "twitch_followers", "showcase_card_id": "followers_global", "route_priority": 1, "status": "active" }

Liên kết có thể khác nhau, nhưng với mỗi liên kết hãy xác định trước quy tắc cập nhật.
- Một dịch vụ của nhà cung cấp — một thẻ, nếu nó có tham số và biểu mẫu đặt hàng duy nhất.
- Nhiều dịch vụ của các nhà cung cấp khác nhau — một thẻ, nếu chúng tương thích về yêu cầu và điều kiện.
- Một dịch vụ của nhà cung cấp — nhiều thẻ, nếu gian hàng phân chia nó theo ngôn ngữ, phân khúc hoặc cách bán.
Việc hợp nhất nhiều nhà cung cấp trong một thẻ có nhược điểm: tốc độ, khả dụng và điều kiện thực hiện thực tế có thể khác nhau. Không hợp nhất các tuyến có định dạng liên kết, giới hạn hoặc trường bắt buộc khác nhau.
Nhập danh mục theo từng trang
Nhà cung cấp có thể trả danh mục theo trang thông qua số trang, độ lệch hoặc con trỏ. Phản hồi đầu tiên không nhất thiết chứa tất cả dịch vụ. Hãy yêu cầu trang tiếp theo cho đến khi API truyền con trỏ, liên kết tiếp tục hoặc dấu hiệu rõ ràng khác về sự hiện diện của dữ liệu.
Với phân trang bằng con trỏ, quá trình xử lý như sau: bảng nhận trang, lưu tất cả dịch vụ, đánh dấu chúng là đã tìm thấy trong chu kỳ hiện tại và chỉ sau đó chuyển sang con trỏ tiếp theo. Nếu không có trường next_cursor, quá trình duyệt được coi là hoàn tất.
- Tạo mã định danh cho chu kỳ đồng bộ hiện tại.
- Yêu cầu trang đầu tiên và lưu các dịch vụ nhận được.
- Với mỗi dịch vụ, cập nhật trường last_seen_sync bằng mã định danh chu kỳ.
- Lưu con trỏ của trang tiếp theo trước khi thực hiện yêu cầu tiếp theo.
- Sau khi duyệt thành công tất cả các trang, so sánh danh mục với chu kỳ hiện tại.
Nhược điểm của việc tải tuần tự các trang là quá trình nhập đầy đủ có thể mất nhiều thời gian hơn. Các yêu cầu song song tăng tốc quá trình nhưng làm tăng nguy cơ chạm giới hạn API hoặc nhận các trang ở trạng thái danh mục khác nhau.
Không tạo trùng lặp khi đồng bộ lại
Để tìm dịch vụ hiện có, hãy dùng khóa tổng hợp: mã định danh nhà cung cấp và ID bên ngoài của dịch vụ. Mỗi lần nhập lại, trước tiên hãy tìm bản ghi theo cặp này, sau đó cập nhật các trường kỹ thuật. Chỉ tạo bản ghi mới khi không có khóa như vậy.
Không dùng tên, giá hoặc danh mục để loại trùng. Hai dịch vụ khác nhau có thể trùng các giá trị này, và nhà cung cấp có thể đổi tên mục mà không đổi ID bên ngoài. Đối với liên kết với gian hàng cũng cần kiểm soát duy nhất: cùng một tuyến không được xuất hiện hai lần sau khi chạy lại tác vụ.
Nên giới hạn tính duy nhất ở cấp cơ sở dữ liệu: supplier_id + external_service_id cho danh mục nhà cung cấp và supplier_id + external_service_id + showcase_card_id cho ánh xạ. Nhược điểm của ràng buộc cứng là khi có lỗi trong liên kết cũ, sẽ phải sửa nó một cách rõ ràng thay vì tạo bản ghi mới đè lên.
Cách phát hiện dịch vụ đã xóa và biến mất
Chỉ có thể coi dịch vụ là đã biến mất sau khi duyệt thành công hoàn toàn tất cả các trang. Nếu quá trình đồng bộ dừng do lỗi, giới hạn yêu cầu hoặc API không khả dụng, thì không được đánh dấu là đã xóa các mục vắng mặt trong phần danh mục đã tải.
Sau khi nhập hoàn tất, hãy tìm các dịch vụ của nhà cung cấp này có last_seen_sync không bằng mã định danh của chu kỳ hiện tại. Chúng được gán trạng thái «không tìm thấy» hoặc «đã lưu trữ», ngắt khỏi đơn hàng mới và gửi đi kiểm tra. ID bên ngoài, lịch sử thay đổi và liên kết với đơn hàng được giữ lại.
Dịch vụ đã biến mất cần được lưu trữ, không phải xóa. Nhà cung cấp có thể đưa nó trở lại danh mục sau này, thay đổi bộ lọc phản hồi hoặc tạm thời ẩn mục. Liên kết lưu trữ có thể được khôi phục trong lần nhập tiếp theo nếu cùng ID bên ngoài xuất hiện lại.
Phải làm gì khi ID bên ngoài của dịch vụ thay đổi
Nếu nhà cung cấp tạo dịch vụ mới thay cho dịch vụ cũ, không thể tự động coi ID bên ngoài mới là sự tiếp nối của ID trước đó. Ngay cả khi tên và giá giống nhau, yêu cầu đặt hàng, khu vực địa lý, loại đối tượng hoặc điều kiện bồi hoàn của mục có thể đã thay đổi.
Hãy chuyển liên kết cũ sang lưu trữ, gỡ tuyến khỏi bán và giữ nó cho các đơn hàng cũ. Nhập dịch vụ mới như một bản ghi riêng. Sau đó tạo ánh xạ mới thủ công hoặc theo quy tắc an toàn nếu các tham số kỹ thuật hoàn toàn tương thích.
Việc tự động ánh xạ theo tên có thể tăng tốc công việc, nhưng nhược điểm là nguy cơ gửi đơn hàng đến dịch vụ khác với điều kiện không phù hợp. Để thay đổi ID, nên dùng trạng thái «cần kiểm tra» thay vì thay thế tuyến một cách âm thầm.
Thiết lập ánh xạ theo các trường kỹ thuật ổn định
Việc phân bổ dịch vụ tự động nên được xây dựng dựa trên một tập trường: nền tảng, loại dịch vụ, khu vực địa lý, định dạng liên kết, khối lượng tối thiểu, tham số bổ sung và trạng thái. Ví dụ, dịch vụ có thể vào danh mục lượt xem theo địa lý nếu API truyền các giá trị tương thích về nền tảng, loại quảng bá và quốc gia.
Nếu nhà cung cấp yêu cầu bình luận, danh sách hồ sơ hoặc khởi chạy thủ công, không xuất bản tuyến trong biểu mẫu đặt hàng tiêu chuẩn. Hãy dùng thẻ riêng với các trường cần thiết hoặc để dịch vụ ẩn cho đến khi hoàn thiện tích hợp.
Chỉ được dùng tên như một dấu hiệu bổ sung. Nhược điểm của quy tắc như vậy là nhà cung cấp có thể thay đổi cách diễn đạt, thêm viết tắt hoặc dùng cách viết khác. Các tuyến quan trọng nên gắn với ID bên ngoài và các tham số phản hồi có thể kiểm tra.
Tách dữ liệu API và cài đặt thẻ
Quá trình nhập không được ghi đè hoàn toàn thẻ gian hàng. Giá mua, giới hạn, khả dụng và tham số kỹ thuật thường được cập nhật từ nhà cung cấp. Tên dành cho khách hàng, mô tả, khả năng hiển thị, thứ tự hiển thị và quy tắc đánh giá giữ nguyên là cài đặt nội bộ của bảng.
Với mỗi trường, hãy chỉ định nguồn chân lý. Ví dụ, khối lượng tối thiểu lấy từ API, tên khách hàng — từ bảng, còn giá gian hàng được tính theo quy tắc nội bộ dựa trên giá mua. Không có sự tách biệt như vậy, quá trình đồng bộ có thể xóa mô tả đã chỉnh sửa thủ công hoặc thay đổi danh mục theo tên bên ngoài.
Kiểm tra thay đổi giá và tham số
Nếu nhà cung cấp thay đổi giá, hãy tính lại giá gian hàng theo quy tắc của thẻ và kiểm tra tiền tệ, hoa hồng và biên lợi nhuận cho phép. Khi thiếu giá, tiền tệ không xác định hoặc điều kiện thay đổi đáng kể, tốt hơn nên chuyển tuyến sang trạng thái kiểm tra.
Khi thay đổi mức tối thiểu, tối đa hoặc bước số lượng, hãy cập nhật biểu mẫu đặt hàng. Nếu biểu mẫu không hỗ trợ các giới hạn mới, hãy gỡ tuyến khỏi bán. Nếu không, khách hàng sẽ đặt đơn hàng mà nhà cung cấp sẽ từ chối sau khi gửi.
Nếu định dạng liên kết, trường bắt buộc, loại dịch vụ hoặc cách khởi chạy thay đổi, hãy chặn đơn hàng mới cho đến khi kiểm tra thủ công. Nhược điểm của việc chặn nghiêm ngặt là một số thẻ tạm thời biến mất khỏi gian hàng, nhưng điều này an toàn hơn so với việc nhận đơn hàng không tương thích.
Xử lý lỗi API và giới hạn yêu cầu
Lỗi của một yêu cầu không được tự động tắt toàn bộ danh mục. Hãy phân biệt lỗi ủy quyền, yêu cầu không hợp lệ, không khả dụng tạm thời và giới hạn tần suất yêu cầu. Mỗi nhóm cần một kịch bản riêng.
- Khi có lỗi ủy quyền, hãy dừng đơn hàng mới cho nhà cung cấp này và kiểm tra quyền truy cập.
- Khi có lỗi định dạng yêu cầu, hãy lưu phản hồi API và sửa tích hợp mà không lặp lại vô hạn.
- Khi có lỗi tạm thời, hãy lặp lại yêu cầu với khoảng dừng tăng dần.
- Khi bị giới hạn tần suất, hãy lưu con trỏ hiện tại và chuyển tác vụ sang chế độ lặp lại.
Không đánh dấu dịch vụ là đã biến mất cho đến khi quá trình đồng bộ bị hoãn hoàn tất thành công. Nhược điểm của việc lặp lại quá mạnh là có thể nhanh chóng cạn giới hạn yêu cầu và khiến danh mục bị lỗi thời trong thời gian dài hơn.
Giữ tuyến cho các đơn hàng đang hoạt động
Trạng thái dịch vụ và trạng thái đơn hàng là những thực thể khác nhau. Dịch vụ có thể biến mất khỏi danh mục đối với khách hàng mới, nhưng các đơn hàng cũ theo nó vẫn đang được thực hiện. Việc lưu trữ thẻ hoặc tuyến không được dừng việc kiểm tra trạng thái của các đơn hàng đã tạo.
Với mỗi đơn hàng, hãy lưu ID bên ngoài của dịch vụ, ID bên ngoài của đơn hàng, các tham số đã gửi, giá mua tại thời điểm khởi chạy và lịch sử trạng thái. Nếu nhà cung cấp thông báo thực hiện một phần, hủy hoặc lỗi, hãy xử lý tình huống theo quy tắc của bảng: hoàn tiền, bồi hoàn, khởi chạy bổ sung hoặc kiểm tra thủ công.
Nhược điểm của việc lưu bản chụp tham số đơn hàng là cần nhiều dung lượng hơn và sơ đồ dữ liệu cẩn thận. Không có bản chụp như vậy, không thể xác định đơn hàng đã được gửi với điều kiện nào nếu nhà cung cấp sau đó thay đổi dịch vụ.
Kiểm tra ánh xạ trước khi xuất bản thẻ
Sau khi thiết lập, hãy kiểm tra toàn bộ đường đi: tạo đơn hàng trong bảng, chọn tuyến, gửi cho nhà cung cấp, lưu ID bên ngoài, nhận trạng thái, hủy và xử lý thực hiện một phần. Hãy kiểm tra các nhóm dịch vụ với giới hạn, liên kết và trường bắt buộc khác nhau.
Riêng biệt, hãy mô phỏng việc nhập lại, thay đổi giá, dịch vụ biến mất sau khi duyệt đầy đủ thành công, lỗi giữa quá trình phân trang và giới hạn tần suất yêu cầu. Điều này sẽ cho thấy liệu bảng có lưu trữ nhầm các tuyến đang hoạt động do tải danh mục không đầy đủ hay không.
Đặc biệt chú ý đến các dịch vụ thủ công và các mục có bình luận. Nhược điểm của chúng là biểu mẫu tiêu chuẩn của bảng thường không truyền tất cả dữ liệu mà nhà cung cấp mong đợi. Đối với chúng, cần có mẫu đặt hàng riêng hoặc trạng thái ẩn cho đến khi hoàn thiện tích hợp API.
Last Articles
Những gì đã thay đổi về thiết kế và tính năng Chúng tôi đã cập nhật trang web để làm việc với nó nhanh hơn và tiện lợi hơn. Các thay đổi chính liên q..
Good afternoon, I've collected all the news during this time.: 1. The main news is that prices for twitch viewers have been greatly reduced, while Tw..
1. Sử dụng mã khuyến mãi "December2025" để được giảm giá 15% cho tất cả người xem của chúng tôi2. Chúng tôi đã giảm 25% giá cơ bản cho công cụ cấu hìn..
Dịch vụ Twitch là làm việc ổn định, vì vậy chúng tôi sẵn sàng hợp tác với các đội, đại lý, chủ sở hữu dịch vụ, chủ sở hữu bot và nhiều người khác...
Chúng tôi đã cập nhật hoàn toàn Các Dịch vụ Twitch viewer của chúng tôi và hiện tại làm việc ổn định. Chúng tôi chỉ sử dụng ĐỊA chỉ IP chất lượng ..
Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..
Greetings, I have compiled a guide for streamers, which will be very relevant at the moment. Now YouTube and twitch have disabled monetization from vi..
We have finally developed the APINow it will be more convenient for our partner sites to work with us.To update the maximum tariffs for YouTube, an up..
Do sự phổ biến rộng rãi của các dịch vụ đối tác và chương trình giới thiệu, chúng tôi đã tạo ra một bảng hợp tác. Bản chất rất đơn giản: nhiều khán gi..
Dịch Vụ Của Chúng Tôi Dành Cho Streamer
Dịch Vụ Của Chúng Tôi Dành Cho Người Sáng Tạo Nội Dung










