Getting started
Giới thiệu
Documentation for the REST APIs and MCP server that bring esimoa eSIMs to your website, app or AI assistant.
What you can build#
- API tìm kiếm eSIM — Tìm eSIM của esimoa theo quốc gia, thời hạn và dữ liệu, rồi hiển thị kèm giá theo thời gian thực trên trang web hoặc ứng dụng của bạn.
- Hoa hồng từ liên kết theo dõi — Mọi liên kết mua hàng trong phản hồi API đều chứa mã đối tác của bạn. Khi khách hàng thanh toán qua đó, bạn sẽ nhận hoa hồng.
- Tích hợp AI (MCP) — Kết nối máy chủ MCP của esimoa với ChatGPT, Claude hoặc Gemini để AI có thể tìm kiếm, so sánh và gửi liên kết eSIM.
- API đối tác (B2B) — Đại lý và đối tác B2B đã ký hợp đồng có thể lấy danh mục sản phẩm esimoa từ phía máy chủ để xây dựng cửa hàng riêng.
Which API should I use?#
esimoa có hai REST API với khóa riêng. Với hầu hết trang web, blog và sản phẩm AI, chỉ cần Public API là đủ.
| API công khai (/v1) | API đối tác (B2B) | |
|---|---|---|
| Đối tượng | Đối tác liên kết — bất kỳ ai có tài khoản esimoa | Đại lý và đối tác B2B đã ký hợp đồng |
| Cấp khóa | Bảng điều khiển Trung tâm nhà phát triển | Cổng đối tác |
| Định dạng khóa | esk_live_<32> | esk_live_<10>_<40> |
| URL cơ sở | https://api.esimoa.com/v1 | https://api.esimoa.com/b2b/v1 |
| Cách bạn kiếm tiền | Hoa hồng cho giao dịch mua qua liên kết theo dõi trong phản hồi | Theo hợp đồng của bạn |
Cách hoạt động#
- 1Đăng nhập bằng tài khoản esimoa, nhập thông tin trang web và nhận mã đối tác ngay lập tức.
- 2Tạo khóa API trong bảng điều khiển. Khóa chỉ hiển thị một lần.
- 3Hiển thị sản phẩm từ API cùng url của chúng (có chứa mã đối tác của bạn).
- 4Khi khách hàng thanh toán qua liên kết, hoa hồng sẽ được ghi nhận trong bảng điều khiển của bạn.