Entegre Et

Bir komut dosyasından ya da bir ajandan dokümantasyon oluşturun

Bir REST API, bir CLI ve Claude Code, Cursor ile diğer ajanlar için bir ajan becerisi, uygulamanın yaptığı eylemlerin aynılarını çağırır. Bir videodan dokümantasyon oluşturun, bir makaleyi düzenleyin ve yayınlayın, Solo / Küçük Ekip planı ve üzerinde.

Uygulamanın dışından bir çağrı
POST/api/external/v2/generate
202Kabul edildi, iş kuyruğa alındı

Tek bir dokümantasyon API'si, sekiz uç nokta grubu

Makaleler, klasörler, şablonlar, videolar, oluşturma, proje ayarları, yayınlama ve dışa aktarma tek bir OpenAPI belirtiminde belgelenir, bir tarayıcının ya da bir kod üretecinin okuyabileceği referansın aynısı. Çeviri, sürüm geri yükleme ve yeniden oluşturma bu grupların içinde yer alır.

Makaleler, klasörler ve şablonlar

Makaleleri ve klasörleri oluşturun, güncelleyin, taşıyın ve silin, şablonları okuyun, her isteği doğrulayan bir X-API-Key başlığıyla.
Bu nasıl çalışır
PUT/api/external/v2/articles/{id}X-API-Key: <your key>{ "title": "Reset your password" }

Oluşturun, sonra işi kontrol edin

Oluşturma uç noktasını bir videoya yönlendirin, bir iş kuyruğa alınır. İşin durumunu kimliğiyle sorgulayın, uygulamanın uzun süren bir çalışma için kendi kullandığı eşzamansız desenin aynısı.
Bu nasıl çalışır
POST/api/external/v2/generate{ "videoId": "<video id>" }202 { "jobId": "<job id>", "type": "generate_article" }GET/api/external/v2/generate/{jobId}200 { "status": "completed" }

Proje ayarları ve yayınlama

Proje ayarlarını okuyun ve güncelleyin, yayınlayın, yeniden yayınlayın ya da yayından kaldırın, uygulama içi ayarlar ekranının kullandığı yayınlama hattının aynısı üzerinden.
Bu nasıl çalışır
POST/api/external/v2/publishPOST/api/external/v2/publish/republishDELETE/api/external/v2/publish

Sorgulamak yerine imzalı bir geri arama alın

Bir oluşturma, yeniden oluşturma, çeviri ya da yayınlama çağrısına bir callbackUrl ekleyin, Hinto iş bittiğinde ya da başarısız olduğunda ona istek gönderir. Bir callbackSecret ekleyin, her çağrı gövdenin HMAC-SHA256 değeri olan bir X-Hinto-Signature başlığı taşır, böylece çağrının Hinto'dan geldiğini doğrulayabilirsiniz. Başarısız bir iletim 5 kez denenir.
Bu nasıl çalışır
POST/api/external/v2/generate{ "videoId": "<video id>", "callbackUrl": "<your url>" }POST<your url>X-Hinto-Signature: <hmac>{ "event": "generation.completed", "jobId": "<job id>" }

Dört kapsam, uç nokta başına uygulanır

Her v2 isteği, çalışmadan önce anahtarın kapsamlarını denetler. generate bir iş başlatır, write içerik oluşturur, düzenler ya da taşır, publish yayınlar veya yeniden yayınlar, read ise geri kalan her şeyi kapsar. Bir anahtar yalnızca kendisi için verildiği projede iş görür. Kısıtlı bir anahtar verme henüz geliştirilmediği için bugün her anahtar dört kapsamın tümünü taşır.

KapsamNeye izin verirÖrneğin
readMakaleleri, klasörleri, şablonları, videoları, dışa aktarımları ve iş durumunu okumaGET /articlesGET /generate/{jobId}
writeİçerik oluşturma, taşıma, çoğaltma ve geri yükleme, video yüklemePOST /articles/emptyPATCH /folders/{id}/move
generateOluşturma, yeniden oluşturma ve çeviri başlatma, bağlantıdan video içe aktarmaPOST /generatePOST /videos/import
publishProjeyi yayınlama ve yeniden yayınlamaPOST /publishPOST /publish/republish

Bir terminalden çalıştırın ya da bir ajana verin

CLI aynı API'yi sarar, ajan becerisi de CLI'yı sarar, böylece bir kişi, bir komut dosyası ve Claude Code ya da Cursor gibi bir ajan aynı komutlara ulaşır. Bir komut dosyasının okuyabileceği çıktı için --json, bir iş bitene kadar beklemek için --wait ekleyin.

$npm install -g @hintoai/cli

CLI'yı kurun

$hinto articles list

Projedeki her makaleyi listeleyin

$npx skills add hintoai/hinto-cli

Ajan becerisini kurun

Webhook'lar: dört olay, tek URL, kendi başlıklarınız

Bir proje yayınlama, yeniden yayınlama, yayından kaldırma ve arşivlemede bir webhook tetikler ve kimlik doğrulama için eklediğiniz başlıkları taşır. Her çağrı bir olay adı, proje ve yayın kimliği, bir zaman damgası ve projenin adı ile URL kısa adını gönderir, yani içeriğin kendisini değil, bir şeyin olduğunu ve nerede bulunacağını bildiren bir haber.

  • project.publishProje ilk kez yayınlandığında
  • project.republishProje değişikliklerle yeniden yayınlandığında
  • project.unpublishProje yayından kaldırıldığında
  • project.archiveProje arşivlendiğinde
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"
  }
}
Özel başlıklarınız eklenmiş bir POST olarak gönderilir. Hinto 3 kez dener, her deneme için 30 saniyeye kadar bekler ve bir 4xx yanıtını yeniden denemez.Bu nasıl çalışır

Hâlihazırda kullandığınız araçlara bağlanır

Bir webhook, bir destek gelen kutusu ve bir web sitesi oluşturucu, aynı projeden okuyabilir.

Kendi sistemleriniz için bir webhook

Bir webhook'u kendi uç noktanıza yönlendirin ve bir yayınlama, yeniden yayınlama, yayından kaldırma ya da arşivlemeye gerçekleştiği anda tepki verin.

Intercom Fin buradan yanıtlar

Bir projenin içeriğini Intercom'a eşitleyin, böylece Intercom'un destek ajanı Fin, Hinto'nun ürettiğinden yanıt verir.

Framer onu sitenize aktarır

Bir Framer eklentisi, Framer'da kurulup barındırılan bir site için makaleleri ve klasörleri Framer CMS'ine aktarır.

Hinto API'si, CLI ve ajan becerisiyle ilgili sorular

Hayır. Her istek, tek bir projenin ayarlarında oluşturulan bir anahtar için X-API-Key başlığı taşır.

Daha İyi Bir
Bilgi Tabanını Daha Hızlı Oluşturmaya Hazır mısınız?

Ücretsiz Başlayın ve İlk Makalenizi Dakikalar İçinde Oluşturun