{ "item": [ { "name": "events", "description": "Поиск мероприятий и доступность мест", "item": [ { "id": "80f9a30e-d392-4ebf-92f5-f7c52bd5cd46", "name": "Поиск и список доступных мероприятий", "request": { "name": "Поиск и список доступных мероприятий", "description": { "content": "Возвращает мероприятия, на которые у партнёра есть грант и которые открыты\nдля продажи. Мероприятие без гранта в выдачу не попадает.\n\n**Поллинг изменений обязателен.** Партнёр опрашивает эту ручку с\n`updated_since` **не реже раза в 5 минут**: это гарантированный канал,\nкоторым доезжают отмена и перенос мероприятия (`status`, `starts_at`) и\nотзыв доступа (`access: \"revoked\"`). Вебхуки появятся позже как\nускоритель и обязательный поллинг не отменят. Отменённое, перенесённое\nили отозванное мероприятие ОСТАЁТСЯ в выдаче с `updated_since`, а не\nмолча исчезает: исчезновение из списка не событие, и партнёр его не\nзаметил бы. Ответ несёт `meta.cursor` для следующего запроса.\n", "type": "text/plain" }, "url": { "path": [ "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Курсор изменений: значение `meta.cursor` из ПРЕДЫДУЩЕГО ответа этой\nручки. Собственное время партнёра сюда не подставляется: часы двух\nсистем расходятся, курсор серверный и непрозрачный. Первый запрос\nделается без параметра. Изменением считаются статус, даты и отзыв\nдоступа; цены и доступность не считаются.\n", "type": "text/plain" }, "key": "updated_since", "value": "" }, { "disabled": false, "description": { "content": "Начало периода по дате начала мероприятия, `YYYY-MM-DD`.", "type": "text/plain" }, "key": "date_from", "value": "" }, { "disabled": false, "description": { "content": "Конец периода включительно, `YYYY-MM-DD`.", "type": "text/plain" }, "key": "date_to", "value": "" }, { "disabled": false, "description": { "content": "Фильтр по объекту (площадке).", "type": "text/plain" }, "key": "venue_id", "value": "" }, { "disabled": false, "description": { "content": "Тип мероприятия, словарь закрыт. (This can only be one of concert,sport,theatre,exhibition,conference,festival,kids,other)", "type": "text/plain" }, "key": "event_type", "value": "theatre" }, { "disabled": false, "description": { "content": "Размер страницы.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "d5a539aa-c444-455e-ba8d-75a53c5f0f5d", "name": "Список мероприятий", "originalRequest": { "url": { "path": [ "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Курсор изменений: значение `meta.cursor` из ПРЕДЫДУЩЕГО ответа этой\nручки. Собственное время партнёра сюда не подставляется: часы двух\nсистем расходятся, курсор серверный и непрозрачный. Первый запрос\nделается без параметра. Изменением считаются статус, даты и отзыв\nдоступа; цены и доступность не считаются.\n", "type": "text/plain" }, "key": "updated_since", "value": "" }, { "disabled": false, "description": { "content": "Начало периода по дате начала мероприятия, `YYYY-MM-DD`.", "type": "text/plain" }, "key": "date_from", "value": "" }, { "disabled": false, "description": { "content": "Конец периода включительно, `YYYY-MM-DD`.", "type": "text/plain" }, "key": "date_to", "value": "" }, { "disabled": false, "description": { "content": "Фильтр по объекту (площадке).", "type": "text/plain" }, "key": "venue_id", "value": "" }, { "disabled": false, "description": { "content": "Тип мероприятия, словарь закрыт. (This can only be one of concert,sport,theatre,exhibition,conference,festival,kids,other)", "type": "text/plain" }, "key": "event_type", "value": "theatre" }, { "disabled": false, "description": { "content": "Размер страницы.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": [\n {\n \"event_id\": \"\",\n \"title\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"venue_id\": \"\",\n \"venue_name\": \"\",\n \"starts_at\": \"\",\n \"status\": \"sales_paused\",\n \"available_seats\": \"\",\n \"price_from_tenge\": \"\",\n \"description\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"event_type\": null,\n \"age_rating\": \"6+\",\n \"ends_at\": \"\",\n \"venue_address\": \"\",\n \"hall_name\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"max_seats_per_booking\": 8,\n \"poster_url\": \"\",\n \"sales_start_at\": \"\",\n \"sales_end_at\": \"\",\n \"access\": \"active\"\n },\n {\n \"event_id\": \"\",\n \"title\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"venue_id\": \"\",\n \"venue_name\": \"\",\n \"starts_at\": \"\",\n \"status\": \"cancelled\",\n \"available_seats\": \"\",\n \"price_from_tenge\": \"\",\n \"description\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"event_type\": \"festival\",\n \"age_rating\": \"18+\",\n \"ends_at\": \"\",\n \"venue_address\": \"\",\n \"hall_name\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"max_seats_per_booking\": 8,\n \"poster_url\": \"\",\n \"sales_start_at\": \"\",\n \"sales_end_at\": \"\",\n \"access\": \"active\"\n }\n ],\n \"meta\": {\n \"total\": \"\",\n \"limit\": \"\",\n \"offset\": \"\",\n \"cursor\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a69b731d-a0d7-4b40-9066-1c8480a534a3", "name": "Ключ неизвестен, подпись не сошлась или `X-Timestamp` вне окна 5 минут.\nКоды: `INVALID_API_KEY`, `INVALID_SIGNATURE`.", "originalRequest": { "url": { "path": [ "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Курсор изменений: значение `meta.cursor` из ПРЕДЫДУЩЕГО ответа этой\nручки. Собственное время партнёра сюда не подставляется: часы двух\nсистем расходятся, курсор серверный и непрозрачный. Первый запрос\nделается без параметра. Изменением считаются статус, даты и отзыв\nдоступа; цены и доступность не считаются.\n", "type": "text/plain" }, "key": "updated_since", "value": "" }, { "disabled": false, "description": { "content": "Начало периода по дате начала мероприятия, `YYYY-MM-DD`.", "type": "text/plain" }, "key": "date_from", "value": "" }, { "disabled": false, "description": { "content": "Конец периода включительно, `YYYY-MM-DD`.", "type": "text/plain" }, "key": "date_to", "value": "" }, { "disabled": false, "description": { "content": "Фильтр по объекту (площадке).", "type": "text/plain" }, "key": "venue_id", "value": "" }, { "disabled": false, "description": { "content": "Тип мероприятия, словарь закрыт. (This can only be one of concert,sport,theatre,exhibition,conference,festival,kids,other)", "type": "text/plain" }, "key": "event_type", "value": "theatre" }, { "disabled": false, "description": { "content": "Размер страницы.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f38c3831-fcf7-4e47-a5a8-e6366b83bb88", "name": "Коды: `INVALID_PARAMETERS` (разбор по полям в `details`, включая\nнеизвестный `sector` в `details.sector`) и `SEATS_UNKNOWN` (место не\nсуществует или чужого мероприятия, список в `details.seats`).", "originalRequest": { "url": { "path": [ "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Курсор изменений: значение `meta.cursor` из ПРЕДЫДУЩЕГО ответа этой\nручки. Собственное время партнёра сюда не подставляется: часы двух\nсистем расходятся, курсор серверный и непрозрачный. Первый запрос\nделается без параметра. Изменением считаются статус, даты и отзыв\nдоступа; цены и доступность не считаются.\n", "type": "text/plain" }, "key": "updated_since", "value": "" }, { "disabled": false, "description": { "content": "Начало периода по дате начала мероприятия, `YYYY-MM-DD`.", "type": "text/plain" }, "key": "date_from", "value": "" }, { "disabled": false, "description": { "content": "Конец периода включительно, `YYYY-MM-DD`.", "type": "text/plain" }, "key": "date_to", "value": "" }, { "disabled": false, "description": { "content": "Фильтр по объекту (площадке).", "type": "text/plain" }, "key": "venue_id", "value": "" }, { "disabled": false, "description": { "content": "Тип мероприятия, словарь закрыт. (This can only be one of concert,sport,theatre,exhibition,conference,festival,kids,other)", "type": "text/plain" }, "key": "event_type", "value": "theatre" }, { "disabled": false, "description": { "content": "Размер страницы.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4f2f3940-6176-437b-a17b-c13058d5b6d7", "name": "Коды: `RATE_LIMIT_EXCEEDED` (частота или конкурентность) и\n`PENDING_LIMIT_EXCEEDED` (слишком много незакрытых `pending`-заказов,\nповторить после `Retry-After`).", "originalRequest": { "url": { "path": [ "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Курсор изменений: значение `meta.cursor` из ПРЕДЫДУЩЕГО ответа этой\nручки. Собственное время партнёра сюда не подставляется: часы двух\nсистем расходятся, курсор серверный и непрозрачный. Первый запрос\nделается без параметра. Изменением считаются статус, даты и отзыв\nдоступа; цены и доступность не считаются.\n", "type": "text/plain" }, "key": "updated_since", "value": "" }, { "disabled": false, "description": { "content": "Начало периода по дате начала мероприятия, `YYYY-MM-DD`.", "type": "text/plain" }, "key": "date_from", "value": "" }, { "disabled": false, "description": { "content": "Конец периода включительно, `YYYY-MM-DD`.", "type": "text/plain" }, "key": "date_to", "value": "" }, { "disabled": false, "description": { "content": "Фильтр по объекту (площадке).", "type": "text/plain" }, "key": "venue_id", "value": "" }, { "disabled": false, "description": { "content": "Тип мероприятия, словарь закрыт. (This can only be one of concert,sport,theatre,exhibition,conference,festival,kids,other)", "type": "text/plain" }, "key": "event_type", "value": "theatre" }, { "disabled": false, "description": { "content": "Размер страницы.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "78158389-0174-4abb-b842-7fec4394f16f", "name": "Карточка мероприятия", "request": { "name": "Карточка мероприятия", "description": { "content": "Текущее состояние одного мероприятия с грантом: обновление страницы\nпартнёра между опросами фида. Отменённое мероприятие с грантом\nчитается.\n", "type": "text/plain" }, "url": { "path": [ "events", ":event_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "event_id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "c5605ca8-957b-43b3-b2d7-4d2629c324c3", "name": "Карточка мероприятия", "originalRequest": { "url": { "path": [ "events", ":event_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "event_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"event_id\": \"\",\n \"title\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"venue_id\": \"\",\n \"venue_name\": \"\",\n \"starts_at\": \"\",\n \"status\": \"sales_scheduled\",\n \"available_seats\": \"\",\n \"price_from_tenge\": \"\",\n \"description\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"event_type\": \"festival\",\n \"age_rating\": \"18+\",\n \"ends_at\": \"\",\n \"venue_address\": \"\",\n \"hall_name\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"max_seats_per_booking\": 8,\n \"poster_url\": \"\",\n \"sales_start_at\": \"\",\n \"sales_end_at\": \"\",\n \"access\": \"active\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b6e9d485-921c-4014-a79a-bca9f075ff32", "name": "Ключ неизвестен, подпись не сошлась или `X-Timestamp` вне окна 5 минут.\nКоды: `INVALID_API_KEY`, `INVALID_SIGNATURE`.", "originalRequest": { "url": { "path": [ "events", ":event_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "event_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "239f5d5f-8751-4b69-b3e7-cf8ee6f2ffa9", "name": "`ACCESS_DENIED`: у партнёра нет гранта на это мероприятие.\n`PARTNER_DISABLED`: доступ партнёра приостановлен ДСС целиком; код\nотличён от проблемы ключа намеренно. Уже созданные заказы при этом\nживут до конца окна: `confirm`/`cancel`/чтения работают.", "originalRequest": { "url": { "path": [ "events", ":event_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "event_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7a874bd9-f65e-4740-acec-d9ba7c2e35d9", "name": "Код: `EVENT_NOT_FOUND`.", "originalRequest": { "url": { "path": [ "events", ":event_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "event_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0683f239-1abf-4778-b9d0-3c44ed445969", "name": "Коды: `RATE_LIMIT_EXCEEDED` (частота или конкурентность) и\n`PENDING_LIMIT_EXCEEDED` (слишком много незакрытых `pending`-заказов,\nповторить после `Retry-After`).", "originalRequest": { "url": { "path": [ "events", ":event_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "event_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "90daae61-1be2-4d5f-b814-3e3d0e383a16", "name": "Доступность мест на мероприятие", "request": { "name": "Доступность мест на мероприятие", "description": { "content": "**Отступление от ТЗ (1 из 6).** ТЗ просит «схему зала с актуальными\nстатусами мест» одним ответом. Платформа отдаёт места ПОСЕКТОРНО: зал\nпервого объекта это 960 мест в шести секторах, и посекторная выдача с\nпосекторным кэшем принята архитектурно.\n\nПоэтому ручка работает в двух режимах:\n\n* без параметра `sector`: сводка по секторам (`sectors`), где для каждого\n сектора есть минимальная цена и число свободных мест;\n* с параметром `sector`: места этого сектора (`seats`).\n\nПартнёр строит схему зала одним запросом сводки и по одному запросу на\nсектор, который открывает пользователь.\n\n**Геометрия для отрисовки:** ДСС по запросу отдаёт публичный SVG-план\nзала, в котором `id` элементов совпадают с `space_id` этого API по\nпостроению (геометрия и данные на платформе разделены именно так).\nЗапросить у технического контакта.\n", "type": "text/plain" }, "url": { "path": [ "events", ":event_id", "seats" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Идентификатор сектора. Без него возвращается сводка по секторам.", "type": "text/plain" }, "key": "sector", "value": "" }, { "disabled": false, "description": { "content": "Фильтр по коду категории билетов. Допустимые значения:\n`standard`, `vip`, `fan`, `invitation`, `service`.\n (This can only be one of standard,vip,fan,invitation,service)", "type": "text/plain" }, "key": "category", "value": "service" } ], "variable": [ { "type": "any", "value": "", "key": "event_id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "61a32ccb-3ddc-49b0-b54a-72566a7a331c", "name": "Сводка по секторам либо места сектора", "originalRequest": { "url": { "path": [ "events", ":event_id", "seats" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Идентификатор сектора. Без него возвращается сводка по секторам.", "type": "text/plain" }, "key": "sector", "value": "" }, { "disabled": false, "description": { "content": "Фильтр по коду категории билетов. Допустимые значения:\n`standard`, `vip`, `fan`, `invitation`, `service`.\n (This can only be one of standard,vip,fan,invitation,service)", "type": "text/plain" }, "key": "category", "value": "service" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "event_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"event_id\": \"\",\n \"sector_id\": \"\",\n \"sectors\": [\n {\n \"sector_id\": \"\",\n \"available_count\": \"\",\n \"sector_code\": \"\",\n \"price_from_tenge\": \"\"\n },\n {\n \"sector_id\": \"\",\n \"available_count\": \"\",\n \"sector_code\": \"\",\n \"price_from_tenge\": \"\"\n }\n ],\n \"seats\": [\n {\n \"space_id\": \"\",\n \"status\": \"sold\",\n \"is_sellable\": \"\",\n \"row_id\": \"\",\n \"row_code\": \"\",\n \"code\": \"\",\n \"seat_ord\": \"\",\n \"category_code\": \"fan\",\n \"price_tenge\": \"\"\n },\n {\n \"space_id\": \"\",\n \"status\": \"blocked\",\n \"is_sellable\": \"\",\n \"row_id\": \"\",\n \"row_code\": \"\",\n \"code\": \"\",\n \"seat_ord\": \"\",\n \"category_code\": \"invitation\",\n \"price_tenge\": \"\"\n }\n ]\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dbc306da-4e0a-41a1-9939-7326a330c73b", "name": "Ключ неизвестен, подпись не сошлась или `X-Timestamp` вне окна 5 минут.\nКоды: `INVALID_API_KEY`, `INVALID_SIGNATURE`.", "originalRequest": { "url": { "path": [ "events", ":event_id", "seats" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Идентификатор сектора. Без него возвращается сводка по секторам.", "type": "text/plain" }, "key": "sector", "value": "" }, { "disabled": false, "description": { "content": "Фильтр по коду категории билетов. Допустимые значения:\n`standard`, `vip`, `fan`, `invitation`, `service`.\n (This can only be one of standard,vip,fan,invitation,service)", "type": "text/plain" }, "key": "category", "value": "service" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "event_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bdd6f4d4-c8ec-4e20-92d4-d214eca2e936", "name": "`ACCESS_DENIED`: у партнёра нет гранта на это мероприятие.\n`PARTNER_DISABLED`: доступ партнёра приостановлен ДСС целиком; код\nотличён от проблемы ключа намеренно. Уже созданные заказы при этом\nживут до конца окна: `confirm`/`cancel`/чтения работают.", "originalRequest": { "url": { "path": [ "events", ":event_id", "seats" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Идентификатор сектора. Без него возвращается сводка по секторам.", "type": "text/plain" }, "key": "sector", "value": "" }, { "disabled": false, "description": { "content": "Фильтр по коду категории билетов. Допустимые значения:\n`standard`, `vip`, `fan`, `invitation`, `service`.\n (This can only be one of standard,vip,fan,invitation,service)", "type": "text/plain" }, "key": "category", "value": "service" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "event_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34b46d95-fa79-4f2b-ac65-7bbf7fe417ab", "name": "Код: `EVENT_NOT_FOUND`.", "originalRequest": { "url": { "path": [ "events", ":event_id", "seats" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Идентификатор сектора. Без него возвращается сводка по секторам.", "type": "text/plain" }, "key": "sector", "value": "" }, { "disabled": false, "description": { "content": "Фильтр по коду категории билетов. Допустимые значения:\n`standard`, `vip`, `fan`, `invitation`, `service`.\n (This can only be one of standard,vip,fan,invitation,service)", "type": "text/plain" }, "key": "category", "value": "service" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "event_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "990352da-66eb-4bfb-8134-f455b01cb40a", "name": "Коды: `INVALID_PARAMETERS` (разбор по полям в `details`, включая\nнеизвестный `sector` в `details.sector`) и `SEATS_UNKNOWN` (место не\nсуществует или чужого мероприятия, список в `details.seats`).", "originalRequest": { "url": { "path": [ "events", ":event_id", "seats" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Идентификатор сектора. Без него возвращается сводка по секторам.", "type": "text/plain" }, "key": "sector", "value": "" }, { "disabled": false, "description": { "content": "Фильтр по коду категории билетов. Допустимые значения:\n`standard`, `vip`, `fan`, `invitation`, `service`.\n (This can only be one of standard,vip,fan,invitation,service)", "type": "text/plain" }, "key": "category", "value": "service" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "event_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ea0b2e54-80af-412a-b644-89f61f9fc284", "name": "Коды: `RATE_LIMIT_EXCEEDED` (частота или конкурентность) и\n`PENDING_LIMIT_EXCEEDED` (слишком много незакрытых `pending`-заказов,\nповторить после `Retry-After`).", "originalRequest": { "url": { "path": [ "events", ":event_id", "seats" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Идентификатор сектора. Без него возвращается сводка по секторам.", "type": "text/plain" }, "key": "sector", "value": "" }, { "disabled": false, "description": { "content": "Фильтр по коду категории билетов. Допустимые значения:\n`standard`, `vip`, `fan`, `invitation`, `service`.\n (This can only be one of standard,vip,fan,invitation,service)", "type": "text/plain" }, "key": "category", "value": "service" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "event_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "bookings", "description": "Временное бронирование", "item": [ { "id": "31679229-12e4-403d-9431-3871f0dcbade", "name": "Временное бронирование мест", "request": { "name": "Временное бронирование мест", "description": { "content": "Удерживает места на срок брони. Захват атомарный: либо удержаны все\nперечисленные места, либо ни одно.\n\nСрок брони настраивается для каждого партнёра, значение по умолчанию\n3 минуты (ТЗ). Точное значение приезжает в `expires_at` и `ttl_seconds`;\nне зашивать его константой.\n\n**Цена фиксируется в момент брони**: `price_tenge` каждого места в\nответе и `total_tenge` брони наследуются заказом как есть. До брони цены\nмогут меняться без предупреждения, поэтому показывать покупателю итог\nстоит из ответа брони, а не из ранее закэшированных чтений.\n\nЛьготных цен в первой фазе интеграции нет: каждое место бронируется по\nполной цене своей категории.\n\nБронь ничего не резервирует за покупателем и не является продажей. По\nистечении срока места освобождаются автоматически.\n\nИдемпотентна по `partner_booking_id`: повтор с тем же значением возвращает\nту же бронь с кодом `200` и не удерживает второй набор мест.\n", "type": "text/plain" }, "url": { "path": [ "bookings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event_id\": \"\",\n \"seats\": [\n \"\"\n ],\n \"partner_booking_id\": \"\",\n \"customer\": {\n \"name\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "fe65b48a-91a3-4b75-aed8-f85aab06fc67", "name": "Повтор с тем же `partner_booking_id`. Возвращается ранее созданная\nбронь, новые места не удерживаются.", "originalRequest": { "url": { "path": [ "bookings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event_id\": \"\",\n \"seats\": [\n \"\"\n ],\n \"partner_booking_id\": \"\",\n \"customer\": {\n \"name\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"booking_id\": \"\",\n \"partner_booking_id\": \"\",\n \"event_id\": \"\",\n \"status\": \"expired\",\n \"seats\": [\n {\n \"space_id\": \"\",\n \"price_tenge\": \"\",\n \"sector_id\": \"\",\n \"row_code\": \"\",\n \"seat_code\": \"\",\n \"category_code\": \"\"\n },\n {\n \"space_id\": \"\",\n \"price_tenge\": \"\",\n \"sector_id\": \"\",\n \"row_code\": \"\",\n \"seat_code\": \"\",\n \"category_code\": \"\"\n }\n ],\n \"expires_at\": \"\",\n \"ttl_seconds\": \"\",\n \"total_tenge\": \"\",\n \"order_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ecf6820c-ddab-4288-a5da-abb96a905d18", "name": "Места удержаны", "originalRequest": { "url": { "path": [ "bookings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event_id\": \"\",\n \"seats\": [\n \"\"\n ],\n \"partner_booking_id\": \"\",\n \"customer\": {\n \"name\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"booking_id\": \"\",\n \"partner_booking_id\": \"\",\n \"event_id\": \"\",\n \"status\": \"expired\",\n \"seats\": [\n {\n \"space_id\": \"\",\n \"price_tenge\": \"\",\n \"sector_id\": \"\",\n \"row_code\": \"\",\n \"seat_code\": \"\",\n \"category_code\": \"\"\n },\n {\n \"space_id\": \"\",\n \"price_tenge\": \"\",\n \"sector_id\": \"\",\n \"row_code\": \"\",\n \"seat_code\": \"\",\n \"category_code\": \"\"\n }\n ],\n \"expires_at\": \"\",\n \"ttl_seconds\": \"\",\n \"total_tenge\": \"\",\n \"order_id\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c955c48c-29a9-4a56-ae29-1e1d3c0b73c2", "name": "Ключ неизвестен, подпись не сошлась или `X-Timestamp` вне окна 5 минут.\nКоды: `INVALID_API_KEY`, `INVALID_SIGNATURE`.", "originalRequest": { "url": { "path": [ "bookings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event_id\": \"\",\n \"seats\": [\n \"\"\n ],\n \"partner_booking_id\": \"\",\n \"customer\": {\n \"name\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "57d0b9dd-fc78-4ea6-afae-ee6845a87b61", "name": "`ACCESS_DENIED`: у партнёра нет гранта на это мероприятие.\n`PARTNER_DISABLED`: доступ партнёра приостановлен ДСС целиком; код\nотличён от проблемы ключа намеренно. Уже созданные заказы при этом\nживут до конца окна: `confirm`/`cancel`/чтения работают.", "originalRequest": { "url": { "path": [ "bookings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event_id\": \"\",\n \"seats\": [\n \"\"\n ],\n \"partner_booking_id\": \"\",\n \"customer\": {\n \"name\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3023df9-f275-49fc-b9b3-ef62b95f7619", "name": "Код: `EVENT_NOT_FOUND`.", "originalRequest": { "url": { "path": [ "bookings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event_id\": \"\",\n \"seats\": [\n \"\"\n ],\n \"partner_booking_id\": \"\",\n \"customer\": {\n \"name\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "42023b9d-a974-4daa-8654-7c23ac17a7fb", "name": "Отказ брони, ни одно место не удержано. Коды этого статуса:\n`SEATS_NOT_AVAILABLE` (место занято, `details.seats`), `SALES_PAUSED` и\n`SALES_NOT_OPEN` (состояние продаж мероприятия), `BOOKING_LIMIT_EXCEEDED`\n(мест больше действующего предела, `details: {limit, requested}`),\n`IDEMPOTENCY_CONFLICT` (ваш ключ с другим телом).", "originalRequest": { "url": { "path": [ "bookings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event_id\": \"\",\n \"seats\": [\n \"\"\n ],\n \"partner_booking_id\": \"\",\n \"customer\": {\n \"name\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "20fa73e7-a9f7-4f35-9964-e6c7a5a6b5d3", "name": "Коды: `INVALID_PARAMETERS` (разбор по полям в `details`, включая\nнеизвестный `sector` в `details.sector`) и `SEATS_UNKNOWN` (место не\nсуществует или чужого мероприятия, список в `details.seats`).", "originalRequest": { "url": { "path": [ "bookings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event_id\": \"\",\n \"seats\": [\n \"\"\n ],\n \"partner_booking_id\": \"\",\n \"customer\": {\n \"name\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24e67935-66d9-4f35-b696-a6f4627faa5c", "name": "Коды: `RATE_LIMIT_EXCEEDED` (частота или конкурентность) и\n`PENDING_LIMIT_EXCEEDED` (слишком много незакрытых `pending`-заказов,\nповторить после `Retry-After`).", "originalRequest": { "url": { "path": [ "bookings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event_id\": \"\",\n \"seats\": [\n \"\"\n ],\n \"partner_booking_id\": \"\",\n \"customer\": {\n \"name\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "orders", "description": "Подтверждение продажи и возврат", "item": [ { "id": "e3a1f82d-a3ff-410a-9dcf-1b10b8f366c3", "name": "Чтение заказа по идентификатору партнёра (восстановление)", "request": { "name": "Чтение заказа по идентификатору партнёра (восстановление)", "description": { "content": "Ручка восстановления и разбора: возвращает заказ по `partner_order_id`\nв его текущем статусе, с билетами, если они выпущены.\n\n**Сценарий, ради которого она существует:** ответ на `POST /orders`\nпотерян (таймаут, падение процесса), `order_id` неизвестен, тело для\nидемпотентного повтора не сохранилось. Этот `GET` отдаёт заказ по\nединственному, что у партнёра точно есть: его собственному\nидентификатору. Дальше `confirm` или `cancel` по полученному `order_id`.\n\nТакже пригодна поддержке партнёра для ручного разбора обращений.\n", "type": "text/plain" }, "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "partner_order_id", "value": "" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "767541a2-3819-4ead-bec3-567f3398744d", "name": "Заказ найден", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "partner_order_id", "value": "" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"order_id\": \"\",\n \"order_number\": \"\",\n \"partner_order_id\": \"\",\n \"event_id\": \"\",\n \"status\": \"refunded\",\n \"total_tenge\": \"\",\n \"created_at\": \"\",\n \"tickets\": [\n {\n \"ticket_id\": \"\",\n \"number\": \"\",\n \"space_id\": \"\",\n \"status\": \"active\",\n \"price_tenge\": \"\",\n \"sector_code\": \"\",\n \"row_code\": \"\",\n \"seat_code\": \"\",\n \"category_name\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"qr_token\": \"\",\n \"pdf_url\": \"\"\n },\n {\n \"ticket_id\": \"\",\n \"number\": \"\",\n \"space_id\": \"\",\n \"status\": \"used\",\n \"price_tenge\": \"\",\n \"sector_code\": \"\",\n \"row_code\": \"\",\n \"seat_code\": \"\",\n \"category_name\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"qr_token\": \"\",\n \"pdf_url\": \"\"\n }\n ],\n \"expires_at\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11882e6a-b1f4-46a1-a432-1a7085f17fa8", "name": "Ключ неизвестен, подпись не сошлась или `X-Timestamp` вне окна 5 минут.\nКоды: `INVALID_API_KEY`, `INVALID_SIGNATURE`.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "partner_order_id", "value": "" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e9786781-6eaf-4faa-9755-cb4009c22134", "name": "Код: `ORDER_NOT_FOUND`. Расширение сверх списка ТЗ.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "partner_order_id", "value": "" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "25e4b3e8-c1b6-43e9-b9ee-7e1fbbfa09e8", "name": "Коды: `INVALID_PARAMETERS` (разбор по полям в `details`, включая\nнеизвестный `sector` в `details.sector`) и `SEATS_UNKNOWN` (место не\nсуществует или чужого мероприятия, список в `details.seats`).", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "partner_order_id", "value": "" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ed899042-0e5e-44a6-9cec-3e7b0587ce4d", "name": "Коды: `RATE_LIMIT_EXCEEDED` (частота или конкурентность) и\n`PENDING_LIMIT_EXCEEDED` (слишком много незакрытых `pending`-заказов,\nповторить после `Retry-After`).", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "partner_order_id", "value": "" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "35d7fd9b-5c9c-432a-aa2d-4b6a2a477ec1", "name": "Оформление заказа до списания денег", "request": { "name": "Оформление заказа до списания денег", "description": { "content": "**Отступление от ТЗ (5 из 6).** В ТЗ этот шаг совмещает подтверждение\nпродажи с передачей платежа. Здесь он разделён на два вызова ради\nпокупателя партнёра: заказ запирает места на платёжное окно ДО списания,\nпоэтому «деньги списаны, а места нет» не существует как класс.\n\nПревращает бронь в заказ со статусом `pending`. Места остаются за заказом\nдо `expires_at` (платёжное окно партнёра, по умолчанию 5 минут,\nнастраивается). Дальше партнёр списывает деньги и зовёт `confirm`; если\nэквайер отказал, зовёт `cancel`. Не случилось ни того ни другого: заказ\nистекает сам, места возвращаются в продажу, подвисших билетов без денег\nне остаётся.\n\nБилеты в этом ответе НЕ приходят: они выпускаются на `confirm`.\n\n**Идемпотентность.** Пара `(партнёр, partner_order_id)` уникальна. Повтор\nтого же `partner_order_id` возвращает тот же заказ с кодом `200` и не\nсоздаёт второго. Пара разных `partner_order_id` на одну бронь это ошибка\n`409 BOOKING_ALREADY_CONFIRMED`; тот же `partner_order_id` с другой\nбронью это `409 IDEMPOTENCY_CONFLICT`.\n\nБронь с истёкшим сроком не превращается в заказ: `409 BOOKING_EXPIRED`.\n", "type": "text/plain" }, "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_id\": \"\",\n \"partner_order_id\": \"\",\n \"customer\": {\n \"email\": \"\",\n \"name\": \"\",\n \"phone\": \"\"\n },\n \"consent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "3b865b8a-8a98-42db-8599-cf1b253a631d", "name": "Повтор с тем же `partner_order_id`. Возвращается ранее созданный\nзаказ в его текущем статусе, ничего не создаётся.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_id\": \"\",\n \"partner_order_id\": \"\",\n \"customer\": {\n \"email\": \"\",\n \"name\": \"\",\n \"phone\": \"\"\n },\n \"consent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"order_id\": \"\",\n \"order_number\": \"\",\n \"partner_order_id\": \"\",\n \"event_id\": \"\",\n \"status\": \"refunded\",\n \"total_tenge\": \"\",\n \"created_at\": \"\",\n \"tickets\": [\n {\n \"ticket_id\": \"\",\n \"number\": \"\",\n \"space_id\": \"\",\n \"status\": \"active\",\n \"price_tenge\": \"\",\n \"sector_code\": \"\",\n \"row_code\": \"\",\n \"seat_code\": \"\",\n \"category_name\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"qr_token\": \"\",\n \"pdf_url\": \"\"\n },\n {\n \"ticket_id\": \"\",\n \"number\": \"\",\n \"space_id\": \"\",\n \"status\": \"used\",\n \"price_tenge\": \"\",\n \"sector_code\": \"\",\n \"row_code\": \"\",\n \"seat_code\": \"\",\n \"category_name\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"qr_token\": \"\",\n \"pdf_url\": \"\"\n }\n ],\n \"expires_at\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e2d11c45-a1e3-4e7b-913c-bf7aff94906c", "name": "Заказ создан, места заперты платёжным окном", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_id\": \"\",\n \"partner_order_id\": \"\",\n \"customer\": {\n \"email\": \"\",\n \"name\": \"\",\n \"phone\": \"\"\n },\n \"consent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"order_id\": \"\",\n \"order_number\": \"\",\n \"partner_order_id\": \"\",\n \"event_id\": \"\",\n \"status\": \"refunded\",\n \"total_tenge\": \"\",\n \"created_at\": \"\",\n \"tickets\": [\n {\n \"ticket_id\": \"\",\n \"number\": \"\",\n \"space_id\": \"\",\n \"status\": \"active\",\n \"price_tenge\": \"\",\n \"sector_code\": \"\",\n \"row_code\": \"\",\n \"seat_code\": \"\",\n \"category_name\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"qr_token\": \"\",\n \"pdf_url\": \"\"\n },\n {\n \"ticket_id\": \"\",\n \"number\": \"\",\n \"space_id\": \"\",\n \"status\": \"used\",\n \"price_tenge\": \"\",\n \"sector_code\": \"\",\n \"row_code\": \"\",\n \"seat_code\": \"\",\n \"category_name\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"qr_token\": \"\",\n \"pdf_url\": \"\"\n }\n ],\n \"expires_at\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "21d68d78-b476-49a2-a9ce-5ea4d0006e83", "name": "Ключ неизвестен, подпись не сошлась или `X-Timestamp` вне окна 5 минут.\nКоды: `INVALID_API_KEY`, `INVALID_SIGNATURE`.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_id\": \"\",\n \"partner_order_id\": \"\",\n \"customer\": {\n \"email\": \"\",\n \"name\": \"\",\n \"phone\": \"\"\n },\n \"consent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "03397dc3-cc93-49a6-bd3f-b89e4d8951bb", "name": "`ACCESS_DENIED`: у партнёра нет гранта на это мероприятие.\n`PARTNER_DISABLED`: доступ партнёра приостановлен ДСС целиком; код\nотличён от проблемы ключа намеренно. Уже созданные заказы при этом\nживут до конца окна: `confirm`/`cancel`/чтения работают.", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_id\": \"\",\n \"partner_order_id\": \"\",\n \"customer\": {\n \"email\": \"\",\n \"name\": \"\",\n \"phone\": \"\"\n },\n \"consent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d285771b-d9b5-4120-af0c-588b5323b1df", "name": "Бронь истекла, не найдена, уже подтверждена другим заказом, либо ваш\n`partner_order_id` уже использован с другой бронью. Коды:\n`BOOKING_EXPIRED`, `BOOKING_ALREADY_CONFIRMED` (расширение),\n`BOOKING_NOT_FOUND` (расширение), `IDEMPOTENCY_CONFLICT` (расширение,\n`details: {field, stored, received}`).", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_id\": \"\",\n \"partner_order_id\": \"\",\n \"customer\": {\n \"email\": \"\",\n \"name\": \"\",\n \"phone\": \"\"\n },\n \"consent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10f86107-7e23-4b8a-91bc-26c0f6c1ac23", "name": "Коды: `INVALID_PARAMETERS` (разбор по полям в `details`, включая\nнеизвестный `sector` в `details.sector`) и `SEATS_UNKNOWN` (место не\nсуществует или чужого мероприятия, список в `details.seats`).", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_id\": \"\",\n \"partner_order_id\": \"\",\n \"customer\": {\n \"email\": \"\",\n \"name\": \"\",\n \"phone\": \"\"\n },\n \"consent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e2f811f8-1e53-46df-a73e-a70491cd001f", "name": "Коды: `RATE_LIMIT_EXCEEDED` (частота или конкурентность) и\n`PENDING_LIMIT_EXCEEDED` (слишком много незакрытых `pending`-заказов,\nповторить после `Retry-After`).", "originalRequest": { "url": { "path": [ "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"booking_id\": \"\",\n \"partner_order_id\": \"\",\n \"customer\": {\n \"email\": \"\",\n \"name\": \"\",\n \"phone\": \"\"\n },\n \"consent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a44b615b-358f-4fe8-8c4e-85d7277c24d8", "name": "Оплата подтверждена, выпуск билетов", "request": { "name": "Оплата подтверждена, выпуск билетов", "description": { "content": "Зовётся СРАЗУ после успешного списания, не из отложенной очереди.\n`payment_info` описывает внешний платёж и сохраняется у ДСС слепком для\nсверки.\n\nБилеты возвращаются в ответе: подписанный `qr_token` для турникета и\n`pdf_url` для скачивания. Писем покупателю ДСС по партнёрскому каналу не\nотправляет: доставка на стороне партнёра.\n\nИдемпотентен: повтор по уже подтверждённому заказу возвращает `200` с\nтеми же билетами. Слепок `payment_info` при повторе не перезаписывается:\nучитывается первый принятый.\n\nОтказ `422` по сумме заказ НЕ убивает: он остаётся `pending`, окно\nпродолжает идти, повтор с верной суммой допустим до `expires_at`.\n\nЗаказ, истёкший до подтверждения: `409 ORDER_EXPIRED`. Деньги в этот\nмомент уже списаны, поэтому партнёр возвращает их покупателю сам и\nнемедленно. Такой исход означает, что между списанием и `confirm` прошло\nбольше платёжного окна: это всегда дефект интеграции, и сверка считает\nкаждый такой случай.\n", "type": "text/plain" }, "url": { "path": [ "orders", ":order_id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "order_id", "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payment_info\": {\n \"amount_tenge\": \"\",\n \"paid_at\": \"\",\n \"external_payment_id\": \"\",\n \"currency\": \"KZT\",\n \"method\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "5dc32445-5936-4367-9290-9c1fe997631e", "name": "Оплата принята, билеты выпущены (повтор возвращает те же)", "originalRequest": { "url": { "path": [ "orders", ":order_id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payment_info\": {\n \"amount_tenge\": \"\",\n \"paid_at\": \"\",\n \"external_payment_id\": \"\",\n \"currency\": \"KZT\",\n \"method\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"order_id\": \"\",\n \"order_number\": \"\",\n \"partner_order_id\": \"\",\n \"event_id\": \"\",\n \"status\": \"refunded\",\n \"total_tenge\": \"\",\n \"created_at\": \"\",\n \"tickets\": [\n {\n \"ticket_id\": \"\",\n \"number\": \"\",\n \"space_id\": \"\",\n \"status\": \"active\",\n \"price_tenge\": \"\",\n \"sector_code\": \"\",\n \"row_code\": \"\",\n \"seat_code\": \"\",\n \"category_name\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"qr_token\": \"\",\n \"pdf_url\": \"\"\n },\n {\n \"ticket_id\": \"\",\n \"number\": \"\",\n \"space_id\": \"\",\n \"status\": \"used\",\n \"price_tenge\": \"\",\n \"sector_code\": \"\",\n \"row_code\": \"\",\n \"seat_code\": \"\",\n \"category_name\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"qr_token\": \"\",\n \"pdf_url\": \"\"\n }\n ],\n \"expires_at\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f45761bf-816f-4e15-947d-069694034f03", "name": "Ключ неизвестен, подпись не сошлась или `X-Timestamp` вне окна 5 минут.\nКоды: `INVALID_API_KEY`, `INVALID_SIGNATURE`.", "originalRequest": { "url": { "path": [ "orders", ":order_id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payment_info\": {\n \"amount_tenge\": \"\",\n \"paid_at\": \"\",\n \"external_payment_id\": \"\",\n \"currency\": \"KZT\",\n \"method\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "372b929c-4808-4efb-ae3f-a7bb0126aeca", "name": "`ACCESS_DENIED`: у партнёра нет гранта на это мероприятие.\n`PARTNER_DISABLED`: доступ партнёра приостановлен ДСС целиком; код\nотличён от проблемы ключа намеренно. Уже созданные заказы при этом\nживут до конца окна: `confirm`/`cancel`/чтения работают.", "originalRequest": { "url": { "path": [ "orders", ":order_id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payment_info\": {\n \"amount_tenge\": \"\",\n \"paid_at\": \"\",\n \"external_payment_id\": \"\",\n \"currency\": \"KZT\",\n \"method\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "29535bdf-88f1-4c94-b9d7-5fcb81a4ca1c", "name": "Код: `ORDER_NOT_FOUND`. Расширение сверх списка ТЗ.", "originalRequest": { "url": { "path": [ "orders", ":order_id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payment_info\": {\n \"amount_tenge\": \"\",\n \"paid_at\": \"\",\n \"external_payment_id\": \"\",\n \"currency\": \"KZT\",\n \"method\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "78216c6f-0dd9-4954-bd27-e5c78479b0c2", "name": "Заказ нельзя подтвердить. Коды: `ORDER_EXPIRED` (окно истекло, места\nвозвращены в продажу; списанное партнёр немедленно возвращает сам),\n`ORDER_CANCELLED` (заказ уже отменён через `cancel`), `EVENT_CANCELLED`\n(мероприятие отменено между заказом и оплатой, партнёр возвращает\nденьги).", "originalRequest": { "url": { "path": [ "orders", ":order_id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payment_info\": {\n \"amount_tenge\": \"\",\n \"paid_at\": \"\",\n \"external_payment_id\": \"\",\n \"currency\": \"KZT\",\n \"method\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2f31d1a0-9ba4-4f7a-ae62-051147f85393", "name": "Коды: `INVALID_PARAMETERS` (разбор по полям в `details`, включая\nнеизвестный `sector` в `details.sector`) и `SEATS_UNKNOWN` (место не\nсуществует или чужого мероприятия, список в `details.seats`).", "originalRequest": { "url": { "path": [ "orders", ":order_id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payment_info\": {\n \"amount_tenge\": \"\",\n \"paid_at\": \"\",\n \"external_payment_id\": \"\",\n \"currency\": \"KZT\",\n \"method\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cc4ccdbc-870f-4e3b-af69-b0b4038f256f", "name": "Коды: `RATE_LIMIT_EXCEEDED` (частота или конкурентность) и\n`PENDING_LIMIT_EXCEEDED` (слишком много незакрытых `pending`-заказов,\nповторить после `Retry-After`).", "originalRequest": { "url": { "path": [ "orders", ":order_id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payment_info\": {\n \"amount_tenge\": \"\",\n \"paid_at\": \"\",\n \"external_payment_id\": \"\",\n \"currency\": \"KZT\",\n \"method\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7ea62b83-f0af-4668-a0bd-730092f995a7", "name": "Списание не удалось, немедленное освобождение мест", "request": { "name": "Списание не удалось, немедленное освобождение мест", "description": { "content": "Зовётся при отказе эквайера. Отменяет `pending`-заказ и возвращает места\nв продажу сразу, не дожидаясь истечения платёжного окна: покупатель,\nкоторый тут же пробует другую карту, не должен ждать собственные места.\n\nИдемпотентен: повтор по уже отменённому или истёкшему заказу возвращает\n`200`. Подтверждённый заказ отменить нельзя (`409 ORDER_NOT_CANCELLABLE`):\nдля оплаченного существует только возврат.\n", "type": "text/plain" }, "url": { "path": [ "orders", ":order_id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "order_id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": null }, "response": [ { "id": "ca8c6f32-36a4-4bf5-90b9-abc7402f898f", "name": "Заказ отменён либо уже был отменён, места свободны", "originalRequest": { "url": { "path": [ "orders", ":order_id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"order_id\": \"\",\n \"order_number\": \"\",\n \"partner_order_id\": \"\",\n \"event_id\": \"\",\n \"status\": \"refunded\",\n \"total_tenge\": \"\",\n \"created_at\": \"\",\n \"tickets\": [\n {\n \"ticket_id\": \"\",\n \"number\": \"\",\n \"space_id\": \"\",\n \"status\": \"active\",\n \"price_tenge\": \"\",\n \"sector_code\": \"\",\n \"row_code\": \"\",\n \"seat_code\": \"\",\n \"category_name\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"qr_token\": \"\",\n \"pdf_url\": \"\"\n },\n {\n \"ticket_id\": \"\",\n \"number\": \"\",\n \"space_id\": \"\",\n \"status\": \"used\",\n \"price_tenge\": \"\",\n \"sector_code\": \"\",\n \"row_code\": \"\",\n \"seat_code\": \"\",\n \"category_name\": {\n \"ru\": \"\",\n \"kk\": \"\",\n \"en\": \"\"\n },\n \"qr_token\": \"\",\n \"pdf_url\": \"\"\n }\n ],\n \"expires_at\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "acc73efa-85a8-463c-9912-127d8739015c", "name": "Ключ неизвестен, подпись не сошлась или `X-Timestamp` вне окна 5 минут.\nКоды: `INVALID_API_KEY`, `INVALID_SIGNATURE`.", "originalRequest": { "url": { "path": [ "orders", ":order_id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f3e3569b-a141-454e-b5db-644848894da8", "name": "`ACCESS_DENIED`: у партнёра нет гранта на это мероприятие.\n`PARTNER_DISABLED`: доступ партнёра приостановлен ДСС целиком; код\nотличён от проблемы ключа намеренно. Уже созданные заказы при этом\nживут до конца окна: `confirm`/`cancel`/чтения работают.", "originalRequest": { "url": { "path": [ "orders", ":order_id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4412c971-5826-4fa8-905a-f75001719f7e", "name": "Код: `ORDER_NOT_FOUND`. Расширение сверх списка ТЗ.", "originalRequest": { "url": { "path": [ "orders", ":order_id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b17535e7-179d-47cf-bc0d-a76c6b5170f1", "name": "Заказ уже подтверждён, отмена невозможна. Код: `ORDER_NOT_CANCELLABLE`\n(расширение), текущий статус в `details`. Для оплаченного заказа\nсуществует только возврат.", "originalRequest": { "url": { "path": [ "orders", ":order_id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0c90a829-9f37-470d-bbf4-a72c4437b69d", "name": "Коды: `RATE_LIMIT_EXCEEDED` (частота или конкурентность) и\n`PENDING_LIMIT_EXCEEDED` (слишком много незакрытых `pending`-заказов,\nповторить после `Retry-After`).", "originalRequest": { "url": { "path": [ "orders", ":order_id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "340ab1c4-a26c-468c-b4c3-329a0754aaf2", "name": "Отметка возврата билетов", "request": { "name": "Отметка возврата билетов", "description": { "content": "⚠️ Доступна со ВТОРОЙ фазы интеграции. До неё возврат оформляется\nобращением в ДСС (контакт и срок обработки фиксируются договором): наш\nперсонал гасит билет вручную, деньги покупателю в любом случае\nвозвращает партнёр у себя.\n\nГасит перечисленные билеты и освобождает их места. Деньги покупателю\nвозвращает партнёр на своей стороне: ДСС отмечает факт и приводит инвентарь\nв соответствие.\n\nПогашенный билет на входе не проходит: контролёр видит отказ с причиной.\nОперация идемпотентна по билету: повтор по уже погашенному билету с той же\nпричиной возвращает успех и не создаёт второй записи.\n\nБилет, по которому гость уже прошёл на объект, не возвращается:\n`409 TICKET_NOT_REFUNDABLE` с текущим статусом в `details`.\n", "type": "text/plain" }, "url": { "path": [ "orders", ":order_id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "order_id", "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"tickets\": [\n \"\"\n ],\n \"reason\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "bf0be24c-fb13-4abf-9911-607be4c4c3fb", "name": "Возврат отмечен", "originalRequest": { "url": { "path": [ "orders", ":order_id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"tickets\": [\n \"\"\n ],\n \"reason\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"data\": {\n \"order_id\": \"\",\n \"status\": \"refunded\",\n \"refunded\": [\n {\n \"ticket_id\": \"\",\n \"number\": \"\",\n \"status\": \"void\"\n },\n {\n \"ticket_id\": \"\",\n \"number\": \"\",\n \"status\": \"void\"\n }\n ],\n \"released_seats\": [\n \"\",\n \"\"\n ]\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "23c88795-09a4-4998-96fc-ea2fb14bd9fb", "name": "Ключ неизвестен, подпись не сошлась или `X-Timestamp` вне окна 5 минут.\nКоды: `INVALID_API_KEY`, `INVALID_SIGNATURE`.", "originalRequest": { "url": { "path": [ "orders", ":order_id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"tickets\": [\n \"\"\n ],\n \"reason\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "25bc326b-eeaa-4e50-9094-9930db84fc83", "name": "`ACCESS_DENIED`: у партнёра нет гранта на это мероприятие.\n`PARTNER_DISABLED`: доступ партнёра приостановлен ДСС целиком; код\nотличён от проблемы ключа намеренно. Уже созданные заказы при этом\nживут до конца окна: `confirm`/`cancel`/чтения работают.", "originalRequest": { "url": { "path": [ "orders", ":order_id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"tickets\": [\n \"\"\n ],\n \"reason\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3bb44e0c-bb9e-49c2-9b79-6d48d61c50a1", "name": "Код: `ORDER_NOT_FOUND`. Расширение сверх списка ТЗ.", "originalRequest": { "url": { "path": [ "orders", ":order_id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"tickets\": [\n \"\"\n ],\n \"reason\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d48a53e6-d11c-4134-a68c-91272315f50e", "name": "Билет уже использован на входе, погашен по другой причине или относится к\nдругому заказу. Код: `TICKET_NOT_REFUNDABLE` (расширение), текущий статус\nв `details`.", "originalRequest": { "url": { "path": [ "orders", ":order_id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"tickets\": [\n \"\"\n ],\n \"reason\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "56ae91c7-5779-49cf-bfa6-1669f8ba4503", "name": "Коды: `INVALID_PARAMETERS` (разбор по полям в `details`, включая\nнеизвестный `sector` в `details.sector`) и `SEATS_UNKNOWN` (место не\nсуществует или чужого мероприятия, список в `details.seats`).", "originalRequest": { "url": { "path": [ "orders", ":order_id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"tickets\": [\n \"\"\n ],\n \"reason\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6013034c-92a9-4659-acb8-a08736b5dd18", "name": "Коды: `RATE_LIMIT_EXCEEDED` (частота или конкурентность) и\n`PENDING_LIMIT_EXCEEDED` (слишком много незакрытых `pending`-заказов,\nповторить после `Retry-After`).", "originalRequest": { "url": { "path": [ "orders", ":order_id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор заказа в системе ДСС, из ответа создания заказа.", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "disabled": false, "description": { "content": "UUID сквозной трассировки. Возвращается тем же заголовком в ответе,\nвключая ответы с ошибкой; пишите его в свой журнал рядом с телом.\n", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"tickets\": [\n \"\"\n ],\n \"reason\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" } ], "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {\n \"key_0\": 1574,\n \"key_1\": 140.0905187261392\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ], "auth": { "type": "apikey", "apikey": [ { "type": "any", "value": "X-Api-Key", "key": "key" }, { "type": "any", "value": "{{apiKey}}", "key": "value" }, { "type": "any", "value": "header", "key": "in" } ] }, "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "exec": [ "// Подпись партнёрского API ДСС: \\n\\n\\n, HMAC-SHA256(secret) в hex.", "// Скрипт коллекции: выполняется перед каждым запросом. Переменные: api_key, secret, baseUrl.", "const secret = pm.variables.get(\"secret\");", "const apiKey = pm.variables.get(\"api_key\");", "if (!secret || !apiKey) {", " throw new Error(\"Задайте переменные api_key и secret в окружении коллекции\");", "}", "const ts = Math.floor(Date.now() / 1000).toString(); // секунды, не миллисекунды", "const method = pm.request.method.toUpperCase();", "const resolved = pm.variables.replaceIn(pm.request.url.toString());", "const u = new URL(resolved);", "const uri = u.pathname + u.search; // путь с query, без хоста, как уходит на провод", "let body = \"\";", "if (pm.request.body && pm.request.body.mode === \"raw\" && pm.request.body.raw) {", " body = pm.variables.replaceIn(pm.request.body.raw);", "}", "const canonical = ts + \"\\n\" + method + \"\\n\" + uri + \"\\n\" + body;", "const sig = CryptoJS.HmacSHA256(canonical, secret).toString(CryptoJS.enc.Hex);", "pm.request.headers.upsert({ key: \"X-Api-Key\", value: apiKey });", "pm.request.headers.upsert({ key: \"X-Timestamp\", value: ts });", "pm.request.headers.upsert({ key: \"X-Signature\", value: sig });", "if (body) {", " pm.request.headers.upsert({ key: \"Content-Type\", value: \"application/json\" });", "}" ] } } ], "variable": [ { "key": "baseUrl", "value": "https://api-sandbox.dss.ndsvs.kz/api/v1/partners", "description": "Адрес стенда или продуктива, с префиксом /api/v1/partners" }, { "key": "api_key", "value": "pk_sandbox_…", "description": "Публичный ключ партнёра, выдаёт ДСС" }, { "key": "secret", "value": "sandbox_secret_do_not_use_in_prod", "description": "Секрет партнёра, ключ HMAC. Значение по умолчанию = секрет проверочного вектора" } ], "info": { "_postman_id": "213f73a7-8fef-496e-84b9-0188bcf2ffbf", "name": "DSS Partner API 0.2.0", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": "Коллекция сгенерирована из partner-api.openapi.yaml. Перед запросом скрипт коллекции считает X-Timestamp и X-Signature из переменных api_key и secret; baseUrl укажите адрес стенда или продуктива." } }