https://travelplatform.ru/docs/operations/avia/seats/seat-map/Recent content in Получение карты мест on Travel API - ДокументацияHugoru-RUhttps://travelplatform.ru/docs/operations/avia/seats/seat-map/request/Mon, 01 Jan 0001 00:00:00 +0000https://travelplatform.ru/docs/operations/avia/seats/seat-map/request/<h1 id="параметры-запроса">Параметры запроса<a class="anchor" href="#%d0%bf%d0%b0%d1%80%d0%b0%d0%bc%d0%b5%d1%82%d1%80%d1%8b-%d0%b7%d0%b0%d0%bf%d1%80%d0%be%d1%81%d0%b0">#</a></h1> <p>Детальное описание всех параметров для запроса <code>/api/avia/seat_map</code>.</p> <h2 id="параметры-запроса-1">Параметры запроса<a class="anchor" href="#%d0%bf%d0%b0%d1%80%d0%b0%d0%bc%d0%b5%d1%82%d1%80%d1%8b-%d0%b7%d0%b0%d0%bf%d1%80%d0%be%d1%81%d0%b0-1">#</a></h2> <p>Запрос должен содержать <strong>ровно один</strong> из двух объектов — <code>offer</code> или <code>booking</code>. Если не передать ни одного или передать оба одновременно, запрос будет отклонен с ошибкой валидации.</p> <table> <thead> <tr> <th>Параметр</th> <th>Тип</th> <th>Обязательно</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>offer</code></td> <td>Offer</td> <td>Один из двух</td> <td>Контекст предложения поиска (карта мест до бронирования)</td> </tr> <tr> <td><code>booking</code></td> <td>Booking</td> <td>Один из двух</td> <td>Контекст бронирования (карта мест после бронирования)</td> </tr> </tbody> </table> <h3 id="структура-offer">Структура offer<a class="anchor" href="#%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0-offer">#</a></h3> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Обязательно</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>segRefId</code></td> <td>string[]</td> <td>Да</td> <td>Идентификаторы сегментов, для которых нужна карта мест (не может быть пустым)</td> </tr> <tr> <td><code>searchId</code></td> <td>string</td> <td>Да</td> <td>Идентификатор поиска из <code>/api/avia/search</code></td> </tr> <tr> <td><code>offerItemId</code></td> <td>string</td> <td>Да</td> <td>Идентификатор варианта тарифа</td> </tr> <tr> <td><code>pax</code></td> <td>Pax[]</td> <td>Да</td> <td>Пассажиры, для которых нужно рассчитать цены мест (не может быть пустым)</td> </tr> </tbody> </table> <h3 id="структура-pax">Структура pax<a class="anchor" href="#%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0-pax">#</a></h3> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Обязательно</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>string</td> <td>Да</td> <td>Идентификатор пассажира (тот же, что позже будет использован в <code>passengers[].id</code> запроса <code>pnr_create</code>)</td> </tr> <tr> <td><code>type</code></td> <td><a href="https://travelplatform.ru/docs/operations/avia/common-types/passenger/#passengertype">PassengerType</a></td> <td>Да</td> <td>Тип пассажира (<code>adt</code>, <code>chd</code>, <code>inf</code>)</td> </tr> </tbody> </table> <h3 id="структура-booking">Структура booking<a class="anchor" href="#%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0-booking">#</a></h3> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Обязательно</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>guid</td> <td>Да</td> <td>Идентификатор бронирования (<code>bookingId</code> из <code>pnr_create</code>/<code>pnr_retrieve</code>)</td> </tr> <tr> <td><code>segRefId</code></td> <td>string[]</td> <td>Да</td> <td>Идентификаторы сегментов из <code>itinerary[].segments[].id</code> ответа <code>pnr_retrieve</code> (не может быть пустым)</td> </tr> </tbody> </table> <hr> <h2 id="как-использовать-параметры">Как использовать параметры<a class="anchor" href="#%d0%ba%d0%b0%d0%ba-%d0%b8%d1%81%d0%bf%d0%be%d0%bb%d1%8c%d0%b7%d0%be%d0%b2%d0%b0%d1%82%d1%8c-%d0%bf%d0%b0%d1%80%d0%b0%d0%bc%d0%b5%d1%82%d1%80%d1%8b">#</a></h2> <h3 id="карта-мест-до-бронирования">Карта мест до бронирования<a class="anchor" href="#%d0%ba%d0%b0%d1%80%d1%82%d0%b0-%d0%bc%d0%b5%d1%81%d1%82-%d0%b4%d0%be-%d0%b1%d1%80%d0%be%d0%bd%d0%b8%d1%80%d0%be%d0%b2%d0%b0%d0%bd%d0%b8%d1%8f">#</a></h3> <p>Используйте <code>offer</code>, когда бронирование еще не создано — сразу после поиска или актуализации цены:</p>https://travelplatform.ru/docs/operations/avia/seats/seat-map/response/Mon, 01 Jan 0001 00:00:00 +0000https://travelplatform.ru/docs/operations/avia/seats/seat-map/response/<h1 id="структура-ответа">Структура ответа<a class="anchor" href="#%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0-%d0%be%d1%82%d0%b2%d0%b5%d1%82%d0%b0">#</a></h1> <p>Детальное описание структуры ответа от <code>/api/avia/seat_map</code>.</p> <h2 id="основная-структура">Основная структура<a class="anchor" href="#%d0%be%d1%81%d0%bd%d0%be%d0%b2%d0%bd%d0%b0%d1%8f-%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0">#</a></h2> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>seatMaps</code></td> <td>array</td> <td>Карты мест по запрошенным сегментам</td> </tr> <tr> <td><code>error</code></td> <td>Error</td> <td>Информация об ошибке (при наличии)</td> </tr> </tbody> </table> <hr> <h2 id="структура-seatmapitem-seatmaps">Структура SeatMapItem (seatMaps[])<a class="anchor" href="#%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0-seatmapitem-seatmaps">#</a></h2> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>segRefId</code></td> <td>string</td> <td>Идентификатор сегмента</td> </tr> <tr> <td><code>equipment</code></td> <td>string</td> <td>Код типа воздушного судна (например, <code>320</code>, <code>73H</code>)</td> </tr> <tr> <td><code>cabinCompartments</code></td> <td>array</td> <td>Компоновки салона с рядами мест</td> </tr> </tbody> </table> <h3 id="структура-cabincompartment">Структура CabinCompartment<a class="anchor" href="#%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0-cabincompartment">#</a></h3> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>deckCode</code></td> <td>string</td> <td>Код палубы (например, <code>M</code> — главная, <code>U</code> — верхняя)</td> </tr> <tr> <td><code>columns</code></td> <td>string[]</td> <td>Буквенные обозначения колонок компоновки (например, <code>A, B, C, D, E, F</code>)</td> </tr> <tr> <td><code>rows</code></td> <td>array</td> <td>Ряды мест в этой компоновке</td> </tr> </tbody> </table> <h3 id="структура-row">Структура Row<a class="anchor" href="#%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0-row">#</a></h3> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>number</code></td> <td>integer</td> <td>Номер ряда</td> </tr> <tr> <td><code>characteristics</code></td> <td>string[]</td> <td>Характеристики ряда (например, аварийный выход, переборка)</td> </tr> <tr> <td><code>seats</code></td> <td>array</td> <td>Места в ряду</td> </tr> </tbody> </table> <h3 id="структура-seat">Структура Seat<a class="anchor" href="#%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0-seat">#</a></h3> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>column</code></td> <td>string</td> <td>Буквенное обозначение места (например, <code>A</code>)</td> </tr> <tr> <td><code>status</code></td> <td><a href="#seatoccupationstatus">SeatOccupationStatus</a></td> <td>Статус места</td> </tr> <tr> <td><code>characteristics</code></td> <td>string[]</td> <td>Характеристики места (окно, проход, дополнительное пространство для ног и т. п.)</td> </tr> <tr> <td><code>pricesByPaxType</code></td> <td>array</td> <td>Цена места по типам пассажиров (присутствует только для платных мест)</td> </tr> </tbody> </table> <h3 id="структура-seatpricebypaxtype">Структура SeatPriceByPaxType<a class="anchor" href="#%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0-seatpricebypaxtype">#</a></h3> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>paxType</code></td> <td><a href="https://travelplatform.ru/docs/operations/avia/common-types/passenger/#passengertype">PassengerType</a></td> <td>Тип пассажира</td> </tr> <tr> <td><code>price</code></td> <td><a href="https://travelplatform.ru/docs/operations/common-types/monetary/#monetaryamount">MonetaryAmount</a></td> <td>Цена места для данного типа пассажира</td> </tr> </tbody> </table> <hr> <h2 id="seatoccupationstatus">SeatOccupationStatus<a class="anchor" href="#seatoccupationstatus">#</a></h2> <p>Статус занятости места.</p>