public

POST `/v1/public/order/recommend`

Recommend hosting from the guided form's answers, with the reasoning.

تصدیق‌هویت

دا پای ټکی عامه دی. دا هېڅ اعتبار او هېڅ سازمان ته اړتیا نه لري - دا هغه څه دي چې زموږ خپله د بازار موندنې پاڼه او د مصنوعي ځيرکتیا د ځواب انجنونه یې لولي.

دا پای نقطه د سازمان هېڅ آی ډي نه اخلي. ستاسو کیلي مخکې تر مخکې هغه سازمان په ګوته کوي چې پورې اړه لري، او ځواب ورته محدود دی.

هڅه وکړئ

د انګلیسي په زاوي پنسونو کې هرڅه د خپلو ارزښتونو سره بدل کړئ، او د کلي ځای لرونکی ستاسو د ډشبورډ د کلي سره.

curl -X POST https://api.zinndigital.com/v1/public/order/recommend \
  -H "Content-Type: application/json" \
  -d '{  }'

ننوتي یاست؟ ستاسو په ډشبورډ کې د API کنسول ستاسو د اصلي سازمان ID او ستاسو خپله کیلي ډکوي، او غوښتنه د ژوندی API په وړاندې پرمخ وړي ترڅو تاسو وکولی شئ اصلي ځواب وګورئ. دا پای ټکی (endpoint) د API په کنسول کې پرانیزئ

تفصیلات

Owner, 2026-09-09: "maybe we also need some smart hosting finder, where they can complete a form type thing to choose what they need like cms, if for pbn, and some other questions and then we recommend them the hosting they need with options on it etc". Computed from entitlements, never from a mapping. A hardcoded {"wordpress": "some_plan"} table is right on the day it is written and wrong the first time a plan is renamed, repriced or retired — and it fails silently, recommending a plan the visitor then cannot buy. Every rule reads a number off the plan they would actually receive. A plan that cannot meet a stated hard requirement — fewer sites than asked for, no SSH when SSH was asked for, no footprint promise when the answer was PBN — is dropped rather than ranked lower. Everything else that does not fit comes back as a caveat on a plan that is still offered: a finder that returns nothing because every plan is a pound over budget has answered nobody's question. reasons and caveats are machine codes, never sentences: we serve 58 languages and every surface renders its own copy, so an English string minted here would reach an Arabic page inside an RTL document. A POST that writes nothing. It is a POST because the answers are a structured body, and because a visitor's traffic, budget and site count do not belong in a URL that proxies, logs and Referer headers all carry.

پارامترونه

نوم	ډول	اړین	دا څه شی دی
`currency (query)`	`string`	نه	ISO-4217 code to price this response in, and the currency `budget_max_minor` is read in. Same contract as on `getPublicOrderConfig`.

د غوښتنې بدن

نوم	ډول	اړین	دا څه شی دی
`purpose`	`string`	نه	`pbn` \| `single_site` \| `store` \| `agency` \| `reseller` \| `app`.
`cms`	`string`	نه	A key from `getPublicHostingFinderOptions`, or `static` / `none`.
`sites`	`integer`	نه	—
`monthly_visits`	`integer`	نه	—
`needs_email`	`boolean`	نه	—
`needs_domain`	`boolean`	نه	—
`needs_ssh`	`boolean`	نه	—
`budget_max_minor`	`integer`	نه	A ceiling in the response currency's minor units. Over-budget plans are still returned, carrying an `over_budget` caveat: a finder that returns nothing because every plan is a…
`limit`	`integer`	نه	—

ځواب

نوم	ډول	اړین	دا څه شی دی
`data`	`HostingRecommendation[]`	هو	—

تېروتنې چې دا پای ټکی یې بیرته راګرځولی شي

422 · 429

POST /v1/public/order/recommend