REST интерфейс

Проверенопроверено 2026-09-20

Накратко

REST интерфейсът е на /api/v1 и отговаря само на GET. Всичко друго получава 405, преди сървърът да погледне ключа.

Достъпът се доказва със заглавка: вижте Преглед.

Извиквания

Адрес	Обхват	Какво връща
`GET /account/connection`	`stores:read`	Диагностика на тази връзка: приложението, кой и кога е разрешил достъпа, предоставени и липсващи разрешения по области, магазини и режим на запис чрез AI.
`GET /account/entitlements`	`account:read`	Тарифата на клиента, функциите и лимитите с текущото използване.
`GET /affiliate/articles/:key`	`affiliate:read`	Една статия за помощ с текста (HTML) на всички или на един език; променливите не са попълнени.
`GET /affiliate/articles`	`affiliate:read`	Статии за помощ на партньорския портал: ключ, по подразбиране/собствена, включване, ред, състояние по езици (заглавие, адрес, попълнена, идентична с тази по подразбиране).
`GET /affiliate/campaigns/:campaignId`	`affiliate:read`	Една кампания на партньорската програма.
`GET /affiliate/campaigns`	`affiliate:read`	Кампаниите на партньорската програма на магазина с възнаграждение, достъпност и бройки.
`GET /affiliate/code-requests`	`affiliate:read`	Заявки на партньорите за собствен код за отстъпка със състояние и причина; чакащите първи.
`GET /affiliate/conversions/:conversionId`	`affiliate:read`	Детайл на една конверсия: суми, комисиона, състояние на комисионата с причина, статус на поръчката в магазина, кредитно известие, изплащане.
`GET /affiliate/conversions`	`affiliate:read`	Конверсии на партньорската програма на магазина: база на комисионата и цялата поръчка с ДДС, комисиона, състояние на комисионата с причина, статус на поръчката в магазина, връзка към изплащането.
`GET /affiliate/discount-codes`	`affiliate:read`	Кодовете за отстъпка на партньорите в магазина с брой използвания и оборот.
`GET /affiliate/documents/:key/content`	`affiliate:read`	Един правен документ на програмата с текста по езици (запазен текст, публичен текст, версия, отпечатъци, източник, PDF метаданни) и отворените чернови.
`GET /affiliate/documents`	`affiliate:read`	Документи на програмата (условия, споразумения): политика на потвърждаване, подписано копие, прикачване към имейл, версии по езици, готовност и брой потвърждения.
`GET /affiliate/email-templates`	`affiliate:read`	Шаблони на имейли до партньорите по езици (тема, включване, със събитие и тяло) и автоматичните прикачени файлове на имейла Акаунтът е одобрен.
`GET /affiliate/links/generate`	`affiliate:read`	Проследявана партньорска връзка към началната страница, продукт или категория на магазина на кампанията; след кликване запазва приписването на партньора.
`GET /affiliate/partners/:partnerId`	`affiliate:read`	Един партньор от програмата с кампаниите, които са му достъпни.
`GET /affiliate/partners`	`affiliate:read`	Партньори от програмата със състояние, резултати и комисиони; контакт само с лични данни.
`GET /affiliate/payouts`	`affiliate:read`	Изплащания на комисиони на партньорите със състояние; без банкови данни и данни за фактуриране.
`GET /affiliate/portal`	`affiliate:read`	Публичен портал на партньора: адреси по магазини, отвореност на регистрацията с причина, собствени домейни, лице за контакт, изглед и състояние на текстовете по езици.
`GET /affiliate/settings`	`affiliate:read`	Настройка на партньорската програма: комисиони, кликвания, минимално изплащане, довеждане.
`GET /affiliate/signatures/:signatureId`	`affiliate:read`	Един електронен подпис с подписания текст и моментна снимка на стойностите; непроменим запис, PDF се сглобява в приложението.
`GET /affiliate/signatures`	`affiliate:read`	Електронно подписани документи на партньорите (кой, документ, версия, език, магазин, час, начин, проверка, отпечатъци, състояние) и партньорите, на които липсва подпис; само четене: подписът възниква изключително в портала.
`GET /affiliate/statistics`	`affiliate:read`	Статистика на партньорската програма: развитие по дни, източници на приписване, класация на партньорите.
`GET /affiliate/summary`	`affiliate:read`	Преглед на партньорската програма на магазина за периода: кликвания, конверсии, комисиони, партньори.
`GET /affiliate/variables`	`affiliate:read`	Регистър на променливите за съдържанието и имейлите на партньорската програма: канонични имена, псевдоними, тип, области, пример; незадължителна проверка на текст за непознати променливи.
`GET /analytics/advertising`	`reports:read`	Реклама: разходи, бюджет, ROAS, дял на рекламните разходи, CPA, средна поръчка и MER със сравнение; Google Ads и Meta Ads, кликове от GA4, 6 месеца.
`GET /analytics/channels`	`analytics:read`	Разпределение на посещенията, поръчките и оборота по маркетингови канали.
`GET /analytics/comparison`	`reports:read`	Оборот със сравнение: оборот, поръчки, AOV, посещения, CR и AI/LLM спрямо предходния период или година.
`GET /analytics/monthly`	`reports:read`	Оборот, поръчки и посещения по месеци (до 24), например година спрямо година.
`GET /analytics/order-coverage`	`analytics:read`	Покритие на поръчките и оборота от измерването в аналитиката.
`GET /analytics/order-heatmap`	`reports:read`	Кога идват поръчките: ден от седмицата × час, най-силен ден и час.
`GET /analytics/overview`	`analytics:read`	Посещения, поръчки, оборот, коефициент на конверсия и дял на AI/LLM за периода.
`GET /analytics/revenue-sources`	`reports:read`	Откъде дойде оборотът: канали, суми за AI/LLM, MitoOps и Affiliate, придобиване според GA4.
`GET /analytics/seo`	`analytics:read`	Search Console: кликвания, показвания, CTR и позиция по заявки или страници.
`GET /automations/catalog`	`automations:read`	Каталог на автоматизациите: задействания, условия, оператори, действия, шаблони; catalogVersion за предложенията.
`GET /automations/:workflowId`	`automations:read`	Една автоматизация с DSL и резултата от валидирането.
`GET /automations`	`automations:read`	Автоматизациите на клиента със състояние и обхват от магазини.
`GET /automations/options`	`automations:read`	Справочник за поле на автоматизацията (статуси, доставки, плащания, шаблони, рекламации…): value за DSL и име.
`GET /automations/:workflowId/runs`	`automations:read`	История на изпълненията на една автоматизация.
`GET /automations/templates`	`automations:read`	Готови шаблони на автоматизации с DSL.
`GET /chatbot/conversations/:sessionId`	`chatbot-conversations:read`	Препис на един разговор с уеб чатбота, включително източниците на отговорите на бота.
`GET /chatbot/conversations`	`chatbot-conversations:read`	Разговори на клиентите с уеб чатбота от последно активния, с първия въпрос; курсор.
`GET /chatbot/outcomes`	`chatbot:read`	How web chatbot conversations ended: since when the outcome is measured, measured and unmeasured conversations, known and unknown outcome, resolved, unresolved, bot error and resolution rate with its denominator; N/A with a reason when the denominator is zero. Totals only.
`GET /chatbot/stats`	`chatbot:read`	Статистика на уеб чатбота за периода: фуния на балончето, отваряния, разговори, резултати, оценки.
`GET /chatbot/topics`	`chatbot:read`	За какво са били разговорите: дялове на темите, продукти, вид на началната страница и кандидати за пропуск в знанията.
`GET /claims/config-drafts/:draftId`	`claims-settings:read`	Състояние на предложението за промяна на настройките на рекламациите (чака, записано, отхвърлено).
`GET /claims/configuration`	`claims-settings:read`	Настройки на рекламациите: етикети, полета, обратен транспорт, формуляр в магазина, типове формуляри.
`GET /claims/:code`	`claims:read`	Един случай с артикулите и връзките: поръчка, кредитно известие, обратна пратка, складово движение.
`GET /claims`	`claims:read`	Рекламации и връщания на един магазин от най-новата.
`GET /claims/refund-options`	`claims-settings:read`	Refunds: variable symbol source, refund coupon validity, coupon in the form, when the form asks for an account number.
`GET /claims/:code/refund-readiness`	`claims:read`	Claim before a refund: what the customer requests, masked account, variable symbol, mode and whether the claim can be deleted.
`GET /claims/refund-settings`	`claims-settings:read`	Възстановявания по рекламации: режим, банкови сметки с пригодност за платежно нареждане (маскирани), основна и ръчна сметка.
`GET /claims/routes`	`claims-settings:read`	Обратен транспорт на рекламации: маршрути, адреси, профили на куриери с ID и поддръжка на връщане, видове случаи.
`GET /claims/settings`	`claims:read`	Процеси на рекламациите с ID и имена (типове, стъпки, статуси, срокове), етикети; настройки на модула с обхвата claims-settings:read.
`GET /claims/statistics`	`claims:read`	Статистика на рекламациите и връщанията за периода: бройки, времена за обработка, типове, оценки, причини.
`GET /claims/templates`	`claims-settings:read`	Шаблони на имейли (тема, текст, кога и дали се изпращат автоматично) и на протоколи за рекламации.
`GET /content/articles`	`products:read`	Статии от блога на магазина с адрес в уебсайта и изображение за преглед.
`GET /coupons/activation-link`	`coupons:read`	Връзка, която прилага СЪЩЕСТВУВАЩ купон в количката на клиента. Не създава купон.
`GET /coupons/activation-status`	`coupons:read`	Може ли купонът да се използва в магазина чрез връзка за активиране: огледало на купона + състояние на кода в уебсайта.
`GET /coupons/capabilities`	`coupons:read`	Какво знае платформата на съответния магазин за купоните. Прочетете преди създаване.
`GET /coupons/:code`	`coupons:read`	Един купон от регистъра на MitoOps. Когато го няма в регистъра, отговорът е „не е намерен“.
`GET /coupons`	`coupons:read`	Купони за отстъпка на магазина с вид и размер на отстъпката, валидност и изведено състояние.
`GET /customers/:customerKey`	`customers:read`	Един клиент от адресната книга: идентичност, магазини, пари за целия период и по желание за периода, разбивка по магазин.
`GET /customers`	`customers:read`	Адресна книга на клиентите: идентичност (с маскиране на лични данни), магазини, език, бройки за целия период и оборот по валути; незадължителен филтър за покупателна активност в периода.
`GET /customers/performance`	`reports:read`	Клиентите като псевдоними: брой поръчки, оборот, първа и последна поръчка, повторна покупка, LTV.
`GET /credit-notes`	`invoices:read`	Търсене в кредитните известия.
`GET /documents`	`invoices:read`	Счетоводни документи от един вид (фактури, проформа фактури, кредитни известия) по страници с жизнен цикъл, състояние в източника, филтър за валидност и наличност на PDF.
`GET /documents/:documentType/:code/pdf`	`invoices:read`	PDF на фактура, проформа фактура или кредитно известие (base64 и SHA-256), същите байтове като на екрана.
`GET /invoices/:invoiceCode`	`invoices:read`	Една фактура с артикули, суми, кредитни известия и проформа фактури към нея.
`GET /invoices`	`invoices:read`	Търсене във фактурите.
`GET /inventory/movements`	`inventory:read`	История на складовите движения: кога, какво, с колко, защо и от какъв източник.
`GET /inventory/availability`	`inventory:read`	Състояние на запасите за няколко артикула наведнъж.
`GET /inventory/stock`	`inventory:read`	Състояние на запаса на един артикул, включително източника на стойността.
`GET /orders/:orderCode`	`orders:read`	Една запазена поръчка, включително артикулите.
`GET /orders`	`orders:read`	Запазени поръчки на един магазин, от най-новата.
`GET /availabilities/drafts/:draftId`	`products:read`	Състояние на предложението за промяна на справочника на наличностите: чака одобрение, записано с резултат, отхвърлено, изтекло.
`GET /availabilities`	`products:read`	Справочник на наличностите на магазина: име, описание, наличност на склад, доставка, значение за Google, цвят, роля по подразбиране.
`GET /catalog/category-content-drafts/:draftId`	`category-content:read`	Статус на предложение за текстове на категории: очаква одобрение, записано, отхвърлено, изтекло.
`GET /categories/:guid/content`	`category-content:read`	Текстове на категория (горно и долно описание, SEO заглавие и описание) с отпечатък и възможност за запис.
`GET /categories`	`products:read`	Категории на магазина с брой продукти.
`GET /catalog/product-content-drafts/:draftId`	`product-content:read`	Статус на предложение за текстове на продукти: очаква одобрение, записано с предупреждения от магазина, отхвърлено, изтекло.
`GET /products/:code/content`	`product-content:read`	Текстове на продукт от магазина (описание, кратко описание, SEO заглавие и описание) с отпечатък и възможност за запис.
`GET /product-content/policy`	`product-content:read`	Политика за съдържанието на магазина без обръщение към магазина: какво този достъп може да чете и предлага, кои полета платформата записва, режим на одобрение и автономен запис, лимити и отпечатъци.
`GET /products/:code`	`products:read`	Един продукт по код, включително класификацията и цената от картата.
`GET /products`	`products:read`	Търсене на продукти по име, код, EAN или PLU.
`GET /reports/financial-summary`	`reports:read`	Финансово обобщение за периода: оборот, ДДС, поръчки, AOV; с права и покупки, брутна печалба, разходи и резултат.
`GET /sales/order-performance`	`reports:read`	Оборот по поръчки в EUR със сборове за целия период; с право и покупки, брутна печалба и марж на поръчка.
`GET /sales/product-performance`	`reports:read`	Продажби по продукти от документите; с право и покупна цена към момента на продажбата и марж.
`GET /search-console/query`	`search-console:read`	Search Console по дни, заявки, страници, държави и устройства, със странициране и хеш на съдържанието.
`GET /search-console/status`	`search-console:read`	Състояние на Search Console на магазина: връзка, собственост, права, синхронизация и обхват на архива.
`GET /shipping/carriers`	`shipping:read`	Свързаните куриери и техните профили, без данни за достъп.
`GET /shipping/shipments/:shipmentId`	`shipping:read`	Една пратка с всички събития от проследяването.
`GET /shipping/shipments`	`shipping:read`	Пратки на един магазин с куриер, държава и часове на предаване и доставка.
`GET /shipping/stats`	`shipping:read`	Статистики на доставките по куриери: бройки, успеваемост, медиана и p90 на времето за доставка, държави.
`GET /stores/integration-status`	`stores:read`	Състояние на кода на MitoOps в уебсайта по магазини: инсталиран, версия, модули, готовност за купон от адреса.
`GET /stores`	`stores:read`	Списък на магазините на клиента заедно с техния код.
`GET /suppliers/:supplierId`	`purchasing:read`	Един доставчик с оферти за продукти и разходни компоненти.
`GET /suppliers`	`purchasing:read`	Доставчиците на клиента с брой оферти и съпоставени продукти.
`GET /webhooks/endpoints/:endpointId/deliveries`	`webhooks:read`	Дневник на доставките на един endpoint без тялото.
`GET /webhooks/endpoints/:endpointId`	`webhooks:read`	Един webhook endpoint с броя на чакащите доставки.
`GET /webhooks/endpoints`	`webhooks:read`	Webhook endpoint-ите на клиента без тайните и състоянието на опашката.
`GET /webhooks/events`	`webhooks:read`	Каталог на събитията на изходящите webhook-ове, плик и подпис.

Адрес	Обхват	Какво връща
`GET /capabilities`	няма	какво може да извика този ключ
`GET /openapi.json`	няма	машинно четимо описание на интерфейса

GET /capabilities е най-бързият начин да разберете какво отваря ключът: връща точно това, което обхватите му позволяват, а не целия каталог. Точните параметри и полета на отговора на всяко извикване са в openapi.json.

Форма на отговора

Всеки отговор има две части: data и meta.

{
  "data": [ { "market": "sk", "name": "Моят магазин" } ],
  "meta": { "requestId": "…", "count": 1 }
}

meta.requestId е идентификаторът на извикването. Ако нещо се обърка, това е данните, които казват на поддръжката за кое извикване става дума.

При списъците meta съдържа и:

Поле	Значение
`count`	колко записа има в този отговор
`hasMore`	`true`, когато следваща страница съществува
`nextCursor`	стойността, с която искате следващата страница; `null`, когато няма такава

При обобщенията (статистики, преглед, финансово обобщение) целият отговор е в data като един обект.

Страниране

Следващата страница искате, като изпратите nextCursor от отговора обратно в параметъра cursor:

curl -H "Authorization: Bearer <Вашият ключ>" \
  "https://<Вашият адрес>/api/v1/shipping/shipments?market=sk&from=2026-08-01&to=2026-08-31&limit=50&cursor=<nextCursor>"

Три неща, на които се основава това:

Останалите параметри трябва да останат същите. Курсорът принадлежи на заявката, с която е създаден. С променен магазин, период или филтър интерфейсът го отхвърля (400): продължаването в ред, който вече не важи, би върнало тихо несвързан откъс.
Края разпознавате по hasMore, а не по броя. Отговорът може да има точно толкова записа, колкото сте поискали, а следваща страница все пак да съществува.
Невалидният курсор е грешка, а не празен резултат. Празен отговор би изглеждал като край на данните и експортът би се съкратил тихо.

С курсор се странират поръчките, документите, каталогът и пратките. Номериране на страници интерфейсът умишлено няма: когато между две извиквания бъде добавен запис, „страница 2“ сочи другаде, отколкото преди малко. Курсорът носи последния видян запис, така че нищо не се повтаря и не се пропуска.

Списък и търсене

При продуктите, фактурите и кредитните известия това са два режима на един и същ адрес:

Как викате	Какво получавате
без `query`	списък по страници, от най-новия; може да се странира и да се ограничи с период
с `query`	търсене, подредено по съвпадение; връща най-много `limit` записа

Търсенето не се странира и не се ограничава с период: редът по съвпадение се променя между извикванията и курсор върху него би прескачал записи. Затова комбинацията на query с cursor, from или to завършва като 400, а не като тихо игнориран филтър.

За изчитане на целия регистър използвайте списъка без query.

Период

Поръчките, документите, пратките, статистиките, аналитиката и отчетите могат да се ограничат с параметрите from и to във формат YYYY-MM-DD.

И двете граници са включително. to=2026-08-05 включва целия 5 август, а не полунощ в началото му.
Денят се взема така, както го води приложението: поръчките в часовата зона на магазина, пратките и отчетите така, както ги вижда служителят на екрана.
Поръчките се подреждат по дата на създаване на поръчката, пратките по дата на създаване на пратката.
Фактурите и кредитните известия по данъчната дата. Когато документът няма попълнена такава, по датата на издаване. Коя стойност е класифицирала документа, се вижда в полето businessDate.
Продажбите по продукти по датата на документа. Тук периодът е задължителен.
Най-дългият период е 366 дни. По-дълъг се отхвърля. По-дълга история преминете по години.
Обърнатият период е грешка, а не празен резултат: иначе печатна грешка би изглеждала като период без документи.
Без период пратките и статистиките връщат последните 30 дни, а аналитиката и финансовото обобщение текущия месец. Отговорът винаги извежда периода.

При поръчките остава и todayOnly. Той не може да се комбинира с from/to: това са два отговора на един и същ въпрос и единият би спечелил тихо.

Какво означават финансовите полета

purchasePriceWithoutVat при артикул от поръчката е покупната цена към момента на поръчката, така както я е запазил магазинът. Това не е цената от днешната карта на продукта: тя е в products/{code} като purchasePrice.
cogs във финансовото обобщение е покупката на стоки за периода от всички поръчки. null означава, че покупните цени не са известни за достатъчно редове (cogsCoverage). Тогава не се показва и брутната печалба: по-добре нищо, отколкото грешно число.
grossProfit е оборотът без ДДС минус покупката на стоки, а grossMargin е същото в проценти. resultAfterCosts е брутната печалба минус доставката минус разходите на фирмата: управленско число, а не счетоводна печалба.
В продажбите по продукти purchaseCostWithoutVat е покупната цена към момента на документа според съпоставянето с каталога. unmappedLines казва колко реда не са съпоставени.
Всички суми в отчетите и аналитиката са в EUR (полето currency), преизчислени по курса към момента на синхронизацията. Поръчките и документите носят собствена валута.

Без обхвата purchase-prices:read тези полета ги няма в отговора: те не са нулеви, те липсват.

Време за доставка

Статистиките на доставките (shipping/stats) измерват времето от предаването на куриера до първото събитие за доставка от събитията на проследяването. От датата на поръчката не се изчислява нищо. Пратка, която няма двете точки, не се включва в медианата. Колко са включени, казва delivery.measured. Същите два часа носи всяка пратка в полетата handedOverAt и deliveredAt.

deliveryRate е делът на доставените от онези, чиято съдба вече е приключила (доставени, върнати, грешни). Пратка в движение все още не е нито успех, нито неуспех. Анулираната пратка е Ваше действие, а не неуспех на куриера, и изобщо не се брои.

Състояние на запасите

inventory/stock връща quantity и source: от кой модел на отчитане идва стойността (варианти, баланс на магазина, карта на продукта). Когато магазинът води баланс, налични са и physical, available (налично за продажба) и reserved (резервирано в поръчки). Иначе те са null. Интерфейсът не измисля никакво „състояние на склада“, което приложението не води.

Състоянието на запасите (inventory/stock и inventory/availability, обхват inventory:read) казва колко стока има. Справочникът на наличностите (/availabilities, обхват products:read) са наименуваните статуси, които магазинът показва на клиента при продукта, например На склад или По заявка.

Справочник на наличностите

GET /availabilities?market=sk връща в data елементите от справочника на един магазин: id, name, description, onStockHours, deliveryHours, meaning (значение за Google Shopping: in_stock, backorder, preorder, out_of_stock), color, system, defaultRoles (роля по подразбиране в магазина) и pairingRows (в колко реда от свързването на наличностите е елементът). meta носи market, manageable и reason: дали справочникът може да се променя в MitoOps и ако не, защо (PLATFORMA, BEZ_ROZSIRENIA, PROSTREDIE).

Промяна на справочника чрез REST не може да се направи. Може да я подготви само асистент чрез MCP, и то като предложение с чувствителния обхват availabilities:draft. В магазина то се записва едва от човек с одобрение в приложението. Състоянието на такова предложение прочитате чрез REST: GET /availabilities/drafts/:draftId връща status (pending, writing, executed, partial, failed, rejected, expired), прегледа и след одобрението резултата по елементи. Подробно в MCP интерфейса.

Адресна книга на клиентите

Клиентите имат два различни начина на четене и да ги бъркате означава да четете различно число от очакваното:

/customers и /customers/{customerKey} (обхват customers:read) са адресната книга: същата проекция, която служителят вижда на екрана Клиенти и която отива в експорта: идентичност, магазини, държава, език, бройки и дати.
/customers/performance (обхват reports:read) е аналитика върху суровите поръчки: клиентът е само псевдоним, а име или контакт в нея изобщо няма.

Отвън market е задължителен и при двете. Без него четенето би минало през всички магазини на клиента, включително тези, които не принадлежат към достъпа.

Кой какво вижда

customers:read сам предоставя псевдоним (customerKey), магазини, държава, език, брой поръчки и датите на първата и последната поръчка. Освен това:

име, фирма, имейл, телефон и маркетингов пол само с personal-data:read,
оборот, средна поръчка и LTV само с reports:read.

Полетата, за които нямате обхват, се премахват, а не се нулират. null на мястото на имейла би означавало „клиентът няма имейл“, което не е вярно: липсващият ключ означава „нямате право на него“.

customerKey е SHA-256 на нормализирания имейл. Това е същият псевдоним, който носят документите (customerEmailHash) и /customers/performance, така че трите изгледа могат да се свържат, без никъде да се изпраща имейл.

Цял живот срещу период

Адресната книга има незадължителен филтър purchaseFrom и purchaseTo (YYYY-MM-DD, двете граници включително). Той означава покупателна активност в периода: клиентът има поне една поръчка в този интервал. Това не е филтър по датата на първата или последната покупка.

С периода се добавят полетата periodFrom, periodTo, periodOrdersCount и periodRevenueByCurrency до тези за целия период (ordersCount, revenue, lifetimeRevenue, firstOrderAt, lastOrderAt), никога вместо тях. Стойностите за целия период не се променят от периода.

Парите винаги са по валути

Оборотът, средната поръчка и LTV са поле по валути, никога едно число. Клиент с поръчки в EUR и в CZK има две позиции. Събирането им в един скалар би означавало да се добавят крони към евро. Същото важи и за /customers/performance: редът е двойка (клиент, валута), а сборовете на филтъра са totals.revenueByCurrency.

Език и маркетингов пол

language е езикът на магазина, в който клиентът е поръчал (source: "store_locale"), а не неговият собствен избор. Днес приложението не води изрично езиково предпочитание на клиента.
marketingGender (male / female / unknown) е оценка по личното име, а не данни, които клиентът е посочил. Произходът винаги е в genderSource (днес изключително name_inference или unknown), а надеждността в genderConfidence. Фирменият клиент няма полето. Който го показва нататък, трябва да казва „оценка по име“, никога „клиентът е посочил“. То е зад personal-data:read, както и самото име.

Онлайн магазин

Извикванията върху данните на един магазин изискват неговия код в параметъра market. Списъка с кодове предоставя GET /stores.

Когато ключът няма обхват за съответния магазин, отговорът е 403, а не празен списък. Празният списък не би могъл да се различи от магазин без поръчки. Запис от друг магазин (например пратка) е 404.

Грешки

Отговорът при грешка винаги има еднаква форма и носи код. Списъкът на състоянията и кодовете е в Преглед.

Примери

# Поръчки за период, по страници
curl -H "Authorization: Bearer <Вашият ключ>" \
  "https://<Вашият адрес>/api/v1/orders?market=sk&from=2026-08-01&to=2026-08-31&limit=50"

# Статистики на доставките за август
curl -H "Authorization: Bearer <Вашият ключ>" \
  "https://<Вашият адрес>/api/v1/shipping/stats?market=sk&from=2026-08-01&to=2026-08-31"

# Пратки на един куриер за август
curl -H "Authorization: Bearer <Вашият ключ>" \
  "https://<Вашият адрес>/api/v1/shipping/shipments?market=sk&from=2026-08-01&to=2026-08-31&carrier=dhl"

# Финансово обобщение за август (с право на покупни цени и брутна печалба)
curl -H "Authorization: Bearer <Вашият ключ>" \
  "https://<Вашият адрес>/api/v1/reports/financial-summary?market=sk&from=2026-08-01&to=2026-08-31"

# Състояние на запасите на три артикула
curl -H "Authorization: Bearer <Вашият ключ>" \
  "https://<Вашият адрес>/api/v1/inventory/availability?market=sk&codes=A100,A101,A102"

# Справочник на наличностите на магазина
curl -H "Authorization: Bearer <Вашият ключ>" \
  "https://<Вашият адрес>/api/v1/availabilities?market=sk"