Баталгаажуулалт
API түлхүүрийг bearer token хэлбэрээр илгөэнэ үү. Түлхүүр нь links.view эрхтэй байх ёстой бөгөөд үүнгүйгээр 404 биш, харин 403 алдаа буцааж татгалзах болно.
Энэ төгсгөл цэг нь ямар ч байгууллагын ID шаардахгүй. Таны түлхүүр аль хэдийн харьяалагдах байгууллагыг тодорхойлж байгаа бөгөөд хариу нь тухайн байгууллагын хүрээнд хязгаарлагдана.
Туршиж үзэх
Өнцөг хаалтанд байгаа бүх зүйлийг өөрийн утгаар солиж, түлхүүр санамж байрлуулагчийг хяналтын самбарынхаа түлхүүрээр сольж оруулна уу.
curl -X GET https://api.zinndigital.com/v1/ai/recipes/{recipeId} \
-H "Authorization: Bearer zdk_live_…"Та нэвтэрсэн байна уу? Таны хяналтын самбар дахь API консол нь таны бодит байгууллагын ID болон өөрийн түлхүүрийг автоматаар бөглөж, шууд ажиллаж буй API рүү хүсэлт илгээх тул та бодит хариуг харах боломжтой болно. Энэ төгсгөлийн цэгийг API консол дээр нээх
Дэлгэрэнгүй
Requires `links.view`.
Параметрүүд
| Нэр | Төрөл | Заавал шаардлагатай | Энэ юу вэ |
|---|---|---|---|
recipeId (path) | Uuid | Тийм | — |
Хариу үйлдэл
| Нэр | Төрөл | Заавал шаардлагатай | Энэ юу вэ |
|---|---|---|---|
id | Uuid | Тийм | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
name | string | Тийм | — |
is_enabled | boolean | Тийм | — |
brief | string | Үгүй | — |
tone | string | Үгүй | — |
word_count | integer | Үгүй | — |
language | string | Үгүй | BCP-47, or empty for "the language the brief is written in". |
posts_per_run | integer | Үгүй | ⛔ Capped at 10. Two hundred articles from one brief are two hundred near-identical articles, which is a **footprint** — the exact thing the Footprint-Free line is sold to avoid. |
provider | string | Үгүй | Blank = whatever the funding route resolves to. |
model_id | string | Үгүй | Blank = the newest verified model in the family. |
model_family | string | Үгүй | — |
anchors | AiAnchor[] | Үгүй | — |
anchor_policy | string<none, every_post, rotate> | Үгүй | — |
link_set_id | string | Үгүй | The reusable link set this recipe draws its links from, or `null` to use the recipe's own `anchors`. When set it **replaces** `anchors` rather than adding to them — two sources… |
cadence | string<manual, daily, weekly, monthly> | Тийм | — |
cadence_hour_utc | integer | Үгүй | — |
cadence_dow | integer | Үгүй | 0 = Monday. |
cadence_dom | integer | Үгүй | ⛔ Never 29-31: a monthly recipe set to the 31st would skip February silently, and a schedule that stops without an error is the failure this feature prevents. |
next_run_at | object | Үгүй | — |
last_run_at | object | Үгүй | — |
target_kind | string<none, sites, site_group, cms_targets> | Үгүй | — |
target_sites | string[] | Үгүй | — |
target_site_group_id | object | Үгүй | — |
target_cms_target_ids | string[] | Үгүй | — |
target_category | string | Үгүй | — |
requires_capabilities | string[] | Үгүй | Capability ids the target must support, e.g. `cms_target:featured_image`. Enforced on every run: each site's capabilities are read from its CMS target and any shortfall is handl… |
capability_policy | string<refuse, degrade, ask> | Үгүй | What to do when a target cannot do something the recipe requires. Default `refuse` — silently dropping a requested field is the failure this exists to stop. `refuse` skips that… |
image_provider | string | Үгүй | — |
image_model | string | Үгүй | — |
featured_image | boolean | Үгүй | — |
inline_image_count | integer | Үгүй | — |
inline_placement | string<after_intro, between_sections, end> | Үгүй | — |
image_style | string | Үгүй | — |
publish_mode | string<draft, schedule, publish> | Тийм | ⚖️ Owner ruling 2026-08-20: a **per-recipe** switch defaulting to `draft`. `draft` writes into the library and schedules nothing; `schedule` queues placements the customer can s… |
schedule_offset_hours | integer | Үгүй | — |
schedule_stagger_minutes | integer | Үгүй | Minutes between consecutive posts in one run. ⛔ Not cosmetic: a network whose articles all appear in the same minute is a footprint. |
blocking_providers | string[] | Үгүй | Providers this recipe needs a working key for and does not have. Empty means it can run now. ⚖️ A recipe naming no provider is never blocked — credits are the default route and… |
created_at | string | Тийм | — |
updated_at | string | Үгүй | — |
Энэ төгсгөл цэгээс буцааж болох алдаанууд
401 · 403 · 404 · 429