Tích hợp

Tạo tài liệu từ một script hoặc một agent

Một REST API, một CLI và một skill cho agent dành cho Claude Code, Cursor và các agent khác gọi đúng những hành động mà ứng dụng vẫn làm. Tạo tài liệu từ một video, chỉnh một bài viết và xuất bản, trên gói Solo / Small Team và cao hơn.

Một lệnh gọi từ bên ngoài ứng dụng
POST/api/external/v2/generate
202Đã nhận, việc đã xếp hàng chờ

Một API tài liệu, tám nhóm điểm cuối

Bài viết, thư mục, mẫu, video, việc tạo nội dung, cài đặt dự án, xuất bản và xuất tệp đều được mô tả trong một đặc tả OpenAPI duy nhất, đúng tài liệu tham chiếu mà một trình duyệt hoặc một trình sinh mã đọc được. Việc dịch, khôi phục phiên bản và tạo lại nằm trong các nhóm đó.

Bài viết, thư mục và mẫu

Tạo, cập nhật, di chuyển và xóa bài viết cùng thư mục, và đọc các mẫu, với một header X-API-Key xác thực từng yêu cầu.
Cách hoạt động
PUT/api/external/v2/articles/{id}X-API-Key: <your key>{ "title": "Reset your password" }

Tạo nội dung, rồi kiểm tra tiến độ

Trỏ điểm cuối generate tới một video và nó xếp một việc vào hàng chờ. Truy vấn việc đó theo id để biết trạng thái, đúng kiểu bất đồng bộ mà chính ứng dụng dùng cho một lượt chạy dài.
Cách hoạt động
POST/api/external/v2/generate{ "videoId": "<video id>" }202 { "jobId": "<job id>", "type": "generate_article" }GET/api/external/v2/generate/{jobId}200 { "status": "completed" }

Cài đặt dự án và xuất bản

Đọc và cập nhật cài đặt dự án, và xuất bản, xuất bản lại hoặc hủy xuất bản, qua đúng quy trình xuất bản mà màn hình cài đặt trong ứng dụng dùng.
Cách hoạt động
POST/api/external/v2/publishPOST/api/external/v2/publish/republishDELETE/api/external/v2/publish

Nhận một callback đã ký thay vì phải truy vấn liên tục

Thêm một callbackUrl vào lệnh gọi generate, regenerate, translate hoặc publish, và Hinto gửi tới đó khi việc kết thúc hoặc thất bại. Thêm một callbackSecret và mỗi lệnh gọi mang một header X-Hinto-Signature, một HMAC-SHA256 của phần thân, để bạn kiểm tra được nó đến từ Hinto. Một lần gửi thất bại được thử lại tối đa 5 lần.
Cách hoạt động
POST/api/external/v2/generate{ "videoId": "<video id>", "callbackUrl": "<your url>" }POST<your url>X-Hinto-Signature: <hmac>{ "event": "generation.completed", "jobId": "<job id>" }

Bốn phạm vi, được kiểm tra ở từng điểm cuối

Mọi yêu cầu v2 đều kiểm tra phạm vi của khóa trước khi chạy. Generate bắt đầu một việc, write tạo, sửa hoặc di chuyển nội dung, publish xuất bản hoặc xuất bản lại, và read bao phủ mọi thứ còn lại. Một khóa chỉ tác động lên dự án nó được cấp cho. Hiện mọi khóa đều mang cả bốn phạm vi, vì việc cấp một khóa bị giới hạn chưa được xây dựng.

Phạm viNó cho phép gìVí dụ
readĐọc bài viết, thư mục, mẫu, video, bản xuất và trạng thái việcGET /articlesGET /generate/{jobId}
writeTạo, di chuyển, nhân bản và khôi phục nội dung, và tải video lênPOST /articles/emptyPATCH /folders/{id}/move
generateBắt đầu việc tạo, tạo lại và dịch, và nhập một video từ một liên kếtPOST /generatePOST /videos/import
publishXuất bản và xuất bản lại dự ánPOST /publishPOST /publish/republish

Chạy nó từ một terminal, hoặc giao nó cho một agent

CLI bọc đúng API đó, và skill cho agent bọc CLI, nên một người, một script và một agent như Claude Code hay Cursor đều đến được cùng những lệnh. Thêm --json để có đầu ra mà script đọc được, và --wait để chờ cho tới khi một việc xong.

$npm install -g @hintoai/cli

Cài CLI

$hinto articles list

Liệt kê mọi bài viết trong dự án

$npx skills add hintoai/hinto-cli

Cài skill cho agent

Webhook: bốn sự kiện, một URL, header của riêng bạn

Một dự án kích hoạt webhook khi xuất bản, xuất bản lại, hủy xuất bản và lưu trữ, mang theo mọi header bạn thêm để xác thực. Mỗi lệnh gọi gửi tên sự kiện, id của dự án và của lần xuất bản, một dấu thời gian, cùng tên và slug URL của dự án, một thông báo rằng có việc đã xảy ra và tìm nó ở đâu, không phải bản thân nội dung.

  • project.publishKhi dự án được xuất bản lần đầu
  • project.republishKhi dự án được xuất bản lại kèm thay đổi
  • project.unpublishKhi dự án bị hủy xuất bản
  • project.archiveKhi dự án được lưu trữ
POSThttps://api.example.com/webhooksContent-Type: application/json
{
  "event": "project.republish",
  "projectId": "<project id>",
  "publicationId": "<publication id>",
  "timestamp": "2026-09-15T10:24:00.000Z",
  "data": {
    "projectName": "Acme Help Center",
    "urlSlug": "acme"
  }
}
Được gửi dưới dạng POST kèm các header tùy chỉnh của bạn. Hinto thử tối đa 3 lần, chờ tối đa 30 giây cho mỗi lần thử, và không thử lại với phản hồi 4xx.Cách hoạt động

Kết nối với những công cụ bạn đang chạy

Một webhook, một hộp thư hỗ trợ và một trình dựng website đều đọc được từ cùng một dự án.

Một webhook cho hệ thống của riêng bạn

Trỏ một webhook tới điểm cuối của riêng bạn và phản ứng ngay khi có một lần xuất bản, xuất bản lại, hủy xuất bản hoặc lưu trữ.

Intercom Fin trả lời từ đó

Đồng bộ nội dung của một dự án vào Intercom để Fin, agent hỗ trợ của Intercom, trả lời từ những gì Hinto đã tạo.

Framer nhập nó vào trang của bạn

Một plugin Framer nhập bài viết và thư mục vào Framer CMS, cho một trang được dựng và lưu trữ trong Framer.

Câu hỏi về API, CLI và skill cho agent của Hinto

Không. Mỗi yêu cầu mang một header X-API-Key, cho một khóa được tạo trong cài đặt của một dự án.

Sẵn sàng xây dựng
cơ sở kiến thức tốt hơn, nhanh hơn?

Dùng thử miễn phí và tạo bài viết đầu tiên chỉ trong vài phút