Cập nhật 29 tháng 9, 2026
Token API cho công cụ ngoài
Tạo token chỉ đọc hoặc đọc ghi, hạn dùng, thu hồi, và cách gọi API danh bạ từ script.
Khi nào cần token
Token API cho phép một app di động hoặc script tự động truy cập sổ danh thiếp thay bạn mà không dùng mật khẩu. Ví dụ: đồng bộ danh bạ sang hệ thống khác mỗi đêm, hoặc tra cứu nhanh từ công cụ nội bộ.
Tạo token
Cài đặt › Token API › Tạo token:
- Tên gợi nhớ: ví dụ “Script đồng bộ CRM”.
- Quyền: Chỉ đọc hoặc Đọc và ghi.
- Không gian: gắn với một sổ, hoặc không gắn (dùng sổ mặc định).
- Hiệu lực: số ngày.
Chuỗi token chỉ hiện một lần. Sao chép ngay; sau này không xem lại được, chỉ tạo mới.
Danh sách token hiện hạn dùng và lần dùng cuối. Thu hồi làm thiết bị đang dùng token đó mất quyền ngay.
Gọi API
Gửi token trong header Authorization. Ví dụ liệt kê 50 liên hệ mới nhất:
curl -H "Authorization: Bearer <token>" \
"https://<địa chỉ app>/api/v1/contacts?size=50&sort=created_desc"Một số đường dẫn hay dùng (tất cả trả JSON):
| Việc | Gọi |
|---|---|
| Danh sách liên hệ, tìm kiếm | GET /api/v1/contacts?q=&country=&group=&page=&size= |
| Một liên hệ | GET /api/v1/contacts/{id} |
| Thống kê sổ | GET /api/v1/contacts/stats |
| Sửa liên hệ (token đọc ghi) | PATCH /api/v1/contacts/{id} |
| Ảnh thẻ | GET /images/{key} với key trong dữ liệu liên hệ |
| Việc đang xử lý | GET /api/v1/jobs |
| Số dư lượt | GET /api/v1/usage/current |
Tải thẻ mới lên qua API dùng cùng luồng nháp / xác nhận như app; tài liệu kỹ thuật đầy đủ có trong kho mã nguồn của dịch vụ khi bạn cần tích hợp sâu.
Giữ token an toàn
- Tạo token chỉ đọc khi chỉ cần tra cứu.
- Đặt hạn dùng ngắn cho script chạy tạm.
- Không dán token vào email hay nhóm chat. Lộ token thì thu hồi ngay và tạo cái mới.