2 bài viết được gắn thẻ "breaking"

API Email nay kiểm tra scope của key, đúng như dashboard vẫn mô tả:

• Gửi email (POST /emails, POST /emails/batch, SMTP relay) và đổi lịch gửi (PATCH /emails/{id}, POST /emails/{id}/cancel) cần email:send.
• Đọc email (GET /emails, GET /emails/{id}, GET /emails/{id}/events) cần email:read; email:send và email:write đã bao gồm quyền này.

Trước đây mọi key hợp lệ đều gọi được các endpoint này. Key thiếu scope giờ nhận 401 restricted_api_key (qua SMTP là 550 5.7.1). Key toàn quyền (*), email:* hoặc email:send không bị ảnh hưởng. Nếu key đang dùng để gửi email chỉ có các scope khác, như email:write hay chat:*, hãy thêm email:send cho key ở mục API Keys trong dashboard.

@hatang/sdk 0.4.0 mặc định gọi https://api.hatang.dev. Trước đây, client tạo mà không có baseUrl hay HATANG_BASE_URL sẽ gọi http://localhost:3001; khi phát triển local giờ hãy truyền baseUrl (hoặc đặt HATANG_BASE_URL).

Lệnh mới:

• Template: templates.create/get/list/update/remove/publish/duplicate, và emails.send({ to, template: { id, variables } }).
• Liên hệ dùng chung: contacts.* không cần audience_id, gọi theo id hoặc email, kèm properties, segments và topics; thêm namespace segments, topics và contactProperties. Truyền audience_id vẫn dùng các route audience cũ.
• Automation: events.*, automations.* và automations.runs.*.
• Số liệu: emails.metrics(), logs.list/get và usage.get.

Namespace blog đã bị bỏ. Xem hướng dẫn Node.js.