Chuyển tới nội dung chính

⚡ Bắt đầu nhanh

Gọi API đầu tiên tới Xbook trong vài phút.

1. Lấy thông tin kết nối

Thông sốMô tả
base_urlĐịa chỉ hệ thống Xbook của bạn, ví dụ https://erp.congty.vn
dbTên database
usernameEmail/đăng nhập của tài khoản API
api_keyKhóa API sinh trong Hồ sơ người dùng → Tài khoản bảo mật → API Keys
mẹo

Luôn dùng API key thay cho mật khẩu để tích hợp tự động. Khóa có thể thu hồi bất kỳ lúc nào mà không đổi mật khẩu.

2. Gọi thử bằng Python

import xmlrpc.client

base_url = "https://erp.congty.vn"
db, username, api_key = "xbook", "dev@congty.vn", "YOUR_API_KEY"

common = xmlrpc.client.ServerProxy(f"{base_url}/xmlrpc/2/common")
uid = common.authenticate(db, username, api_key, {})

models = xmlrpc.client.ServerProxy(f"{base_url}/xmlrpc/2/object")
partners = models.execute_kw(
db, uid, api_key,
"res.partner", "search_read",
[[["customer_rank", ">", 0]]],
{"fields": ["name", "email"], "limit": 5},
)
print(partners)

3. Bước tiếp theo

  • Tìm hiểu cơ chế Xác thực chi tiết.
  • Xem quy ước REST API cho các thao tác CRUD.
  • Đăng ký Webhook để nhận sự kiện.