Tóm tắt: đại lý chỉ cần đăng ký một lần bằng tên pháp lý của mình. Sau đó, đại lý quảng cáo cho khách hàng bằng cách nhập tên từng khách hàng vào Tên hiển thị với thành viên. Đại lý thanh toán, giữ số dư và nhận hóa đơn. Nhà phát triển có thể tạo và quản lý Ưu đãi và Sự kiện qua Agilis REST API (https://ads.agilis.dating) bằng khóa API lấy từ Cổng Quảng cáo. Khóa thử nghiệm được dùng miễn phí và nội dung tạo bằng khóa này không bao giờ hiển thị với thành viên.
Dành cho đại lý
- Đăng ký đại lý bằng tên pháp lý của chính đại lý. → Cách đăng ký
- Khi tạo Ưu đãi hoặc Sự kiện, hãy nhập tên khách hàng vào Tên hiển thị với thành viên. Thành viên sẽ thấy tên khách hàng, không phải tên của Quý vị.
- Quý vị phải được từng khách hàng ủy quyền để quảng cáo cho họ. Theo Điều khoản Quảng cáo, đại lý chịu trách nhiệm về việc này.
Ai thanh toán và ai nhận hóa đơn
- Tài khoản của đại lý thanh toán bằng đơn vị tiền tệ thanh toán của đại lý.
- Mỗi người trong đại lý có số dư riêng và thanh toán từ số dư đó. Số dư tổ chức là tổng của các số dư này. → Cách hoạt động của số dư
- Hóa đơn và kết quả đứng tên đại lý, mỗi lần thanh toán có một hóa đơn, để Quý vị có thể lập hóa đơn lại cho từng khách hàng.
- Để tách riêng chi tiêu của từng khách hàng, hãy dùng mỗi Ưu đãi hoặc Sự kiện cho một khách hàng và lập hóa đơn lại dựa trên hóa đơn tương ứng.
Vai trò trong nhóm
Quản trị viên tổ chức và Nhà quảng cáo làm việc trên Cổng Quảng cáo, còn Nhà phát triển làm việc qua API. Nhà phát triển không thể tạo Ưu đãi hoặc Sự kiện trên Cổng Quảng cáo. Tuy nhiên, với khóa API của mình, họ có thể tạo, đăng và thanh toán cho Ưu đãi và Sự kiện qua API. Doanh nghiệp của Quý vị chịu trách nhiệm về cách sử dụng các khóa này. Bảng đầy đủ có tại Vai trò và quyền hạn trong nhóm.
Agilis REST API
- URL gốc: https://ads.agilis.dating
- Tài liệu tham khảo: www.agilis.dating/api-doc, kèm mã mẫu bằng cURL, Python, Node.js và PHP, cùng một trợ lý API
- Định dạng máy đọc được: OpenAPI 3.1 tại www.agilis.dating/openapi.json, Markdown tại www.agilis.dating/api-doc.md và toàn văn cho công cụ AI tại www.agilis.dating/llms-full.txt
- Ưu đãi: liệt kê danh mục của Quý vị và các sở thích; tính giá Ưu đãi trước khi tạo; tạo, liệt kê, tạm dừng, tiếp tục và xóa Ưu đãi; xem kết quả của từng Ưu đãi
- Sự kiện: xem trước, đăng, liệt kê, chỉnh sửa, đổi lịch, hủy và xóa Sự kiện; xem kết quả của từng Sự kiện
Lấy khóa API
- Đăng nhập vào Cổng Quảng cáo với vai trò Quản trị viên tổ chức hoặc Nhà phát triển.
- Chọn Chế độ thử nghiệm hoặc Chế độ chính thức bằng nút chuyển ở đầu trang.
- Vào Khóa API → Tạo khóa mới, đặt tên cho khóa và chọn ngày hết hạn nếu muốn.
- Sao chép khóa ngay lập tức. Quý vị sẽ không thể xem lại khóa này.
Khóa thử nghiệm bắt đầu bằng pk_test_, khóa chính thức bắt đầu bằng pk_live_. Mỗi người có thể có tối đa 10 khóa ở mỗi chế độ. Thay mới khóa sẽ thay thế khóa ngay lập tức, vì vậy hãy cập nhật hệ thống của Quý vị trước. Gửi khóa trong tiêu đề yêu cầu x-api-key: x-api-key: pk_test_….
Phát triển an toàn
- Phát triển và thử nghiệm với khóa
pk_test_: Ưu đãi và Sự kiện thử nghiệm được dùng miễn phí và không bao giờ hiển thị với thành viên. - Tính giá Ưu đãi bằng endpoint ước tính giá trước khi tạo.
- Không lưu khóa trong kho mã nguồn hay trình duyệt. Hãy gọi API từ máy chủ của Quý vị.
Câu hỏi
Một đại lý có thể quản lý nhiều khách hàng từ một tài khoản không?
Có. Chỉ cần đăng ký đại lý một lần và ghi tên khách hàng trên từng Ưu đãi hoặc Sự kiện.
Mỗi khách hàng có thể có hóa đơn riêng không?
Hóa đơn được xuất cho đại lý của Quý vị, mỗi lần thanh toán có một hóa đơn. Quý vị có thể dựa vào đó để lập hóa đơn lại cho khách hàng.
Có môi trường thử nghiệm (sandbox) không?
Có. Chế độ thử nghiệm, với khóa pk_test_, là một môi trường thử nghiệm đầy đủ. Quý vị không bị tính phí và không có nội dung nào hiển thị với thành viên.
Tôi có thể kết nối công cụ lập trình AI không?
Có. Hãy trỏ công cụ của Quý vị tới www.agilis.dating/api-doc.md hoặc www.agilis.dating/openapi.json.
