Downloads

Двата фајла подолу опишуваат ист API — едниот за алатки што читаат OpenAPI, другиот за Postman.

Фајл	Верзија на API-то	Преземено од API-то на
Машински опис (OpenAPI)	1.0.0	27.08.2026	Преземи
Збирка повици (Postman)	1.0.0	27.08.2026	Преземи

Што значи ова за твојата интеграција

Обата фајла ги објавува самото API — openapi.json е описот што серверот го дава, а збирката за Postman е составена од истиот тој опис. Значи она што го преземаш секогаш го опишува API-то такво какво е во моментот на преземањето, не она што било документирано некогаш.

Практично, од тоа следуваат три работи за тебе:

• Не поправај го фајлот што си го презел. Ако нешто во него изгледа погрешно, поправката доаѓа од нашата страна и стигнува во следното преземање. Поправено во твојата копија, тоа останува само таму — и тивко се разидува од она што серверот навистина прифаќа.
• Преземи одново кога ќе видиш промена во Changelog. Тоа е моментот кога твојата копија заостанува, и единствениот кога тоа се знае однапред.
• Твоите сопствени вредности не одат во фајлот. Клучот и адресата се внесуваат во Postman како варијабли (в. подолу), па новото преземање не ти брише ништо.

Postman

По вчитување на збирката во Postman:

1. Внеси го клучот во варијаблата apiKey — во табот Variables на збирката, полето „CURRENT VALUE”. Placeholder-от <ВАШИОТ КЛУЧ> не е важечка вредност.
2. Повикај проверка на врската — испрати го барањето /api/integration/v1/ping од збирката. Успешен одговор со keyValid: true значи дека клучот е примен, пред да се испрати каков било документ.
3. Не менувај ниту една адреса ниту заглавие. Збирката веќе ги носи точните адреси и заглавија (X-Api-Key, X-Software-Id) за секој повик; менувањето ги раздвојува од описот од кој се генерирани.