Hookestdocs Postman OpenAPI llms.txt

Kimlik

Her /v1/* isteği HTTP Bearer kullanır. x-api-key değil, query değil.

Authorization: Bearer hk_live_…

Query’de api_key veya key her zaman 401 invalid_api_key döner — header geçerli olsa bile.

Anahtarlar hk_live_ + en az 16 URL-safe karakter. Sunucu tarafında tut.

Klibi yükle bir /v1/* rotası değil. PUT upload_url’e Bearer yok — koleksiyon genelinde Authorization o adımı bozar.

Geçerli anahtar yetmez. Hesapta Builder/Growth/Scale (plan_tiers.api_enabled) veya invite/comp/custom gerekir. Yoksa 403 api_not_enabled. Plan kapanınca GET /v1/wallet, GET /v1/predict/{id} ve GET /v1/webhooks açık kalır. Bu GET’ler hâlâ aynı scope’u ister (Get prediction için predict:write). Plan kaybı hesap webhook’unu otomatik kapatır.

Postman: koleksiyon dosyasını import et, bu HTML’i değil. api_key değişkenini set et. Postman.

İstek parametreleri

AdYerTipZorunluAçıklama
Authorization header string Zorunlu Bearer hk_live_ + en az 16 URL-safe karakter. Her /v1/* isteğinde zorunlu. Klibi yüklede gönderme.
api_key query string Reddedilir Her zaman 401 invalid_api_key, Bearer geçerli olsa bile.
key query string Reddedilir api_key ile aynı. Her zaman 401.