tenancy

POST `/v1/me/acquisition-touch`

Record where the signed-in customer came from (the app's landing capture).

Аутентификација

Пошаљите API кључ као bearer токен. Ова крајња тачка не наводи конкретну дозволу у спецификацији, па свом кључу доделите најмања неопходна овлашћења и проверите одговор уместо да претпостављате.

Где се уноси ID ваше организације

Ова крајња тачка узима org_id као поље у JSON телу.

Идентификатор ваше организације се налази на екрану са API кључевима на вашој контролној табли, поред самог кључа. То је исти идентификатор у сваком позиву који упутите.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

curl -X POST https://api.zinndigital.com/v1/me/acquisition-touch \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "touch": <object> }'

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

The dashboard captures utm_*, ref, zd_vid (the product sites' visit id), the referring host and the landing page BEFORE the sign-in hop, and sends them here on the first signed-in page load. This is the only way an app sign-up can be attributed: self-registration provisions the organization inside authentication, which never sees the landing URL (docs/750). Unknown keys are dropped, values are capped, and the landing page is host and path only. Recorded only against an organization the caller OWNS — a member of someone else's account did not bring it to us — and never under impersonation. The first touch is written once and never overwritten; the last touch is overwritten each time. A capture with nothing attributable (no campaign, affiliate code, visit id or foreign referrer) records nothing and answers recorded: false, reason: empty.

Тело захтева

Назив	Тип	Обавезно	Шта је ово
`org_id`	`string`	Не	The org to record against; optional when the caller owns exactly one.
`touch`	`object`	Да	Captured on landing. Kept keys: utm_source, utm_medium, utm_campaign, utm_term, utm_content, gclid, fbclid, ttclid, msclkid, ref, zd_vid, referrer_host, landing_page. Others are…

Одговор

Назив	Тип	Обавезно	Шта је ово
`recorded`	`boolean`	Да	—
`reason`	`string<, empty, impersonation>`	Да	—
`org_id`	`string`	Не	—

Грешке које ова крајња тачка може вратити

401 · 403 · 422