ავტორიზაცია
API გასაღები გაგზავნეთ როგორც მატარებელი ტოკენი (bearer token). გასაღებს უნდა ჰქონდეს links.view ნებართვა; ამის გარეშე გასაღები უარყოფილი იქნება 403 და არა 404 სტატუსით.
ეს ბოლო წერტილი არ იღებს ორგანიზაციის იდენტიფიკატორს. თქვენი გასაღები უკვე აიდენტიფიცირებს იმ ორგანიზაციას, რომელსაც ის ეკუთვნის, და პასუხი შემოფარგლულია მისით.
სცადეთ
შეSubstituted any value inside angle brackets with your own and the key placeholder with a key from your dashboard.
curl -X GET https://api.zinndigital.com/v1/ai/recipes/{recipeId} \
-H "Authorization: Bearer zdk_live_…"შესული ხართ? თქვენი სამართავ პანელში არსებული API კონსოლი ავტომატურად ამატებს თქვენი რეალური ორგანიზაციის ID-სა და საკუთარ გასაღებს და ატარებს მოთხოვნას ცოცხალ API-ს წინააღმდეგ, რათა იხილოთ რეალური პასუხი. გაAღით ეს ენდპოინტი 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