https://travelplatform.ru/docs/operations/dictionary/cities/Recent content in Города on Travel API - ДокументацияHugoru-RUhttps://travelplatform.ru/docs/operations/dictionary/cities/request/Mon, 01 Jan 0001 00:00:00 +0000https://travelplatform.ru/docs/operations/dictionary/cities/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/dictionary/cities</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>Headers</strong></p> <table> <thead> <tr> <th>Header</th> <th>Обязательно</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>Authorization</code></td> <td>Да</td> <td>Bearer token (JWT)</td> </tr> </tbody> </table> <p><strong>Query</strong></p> <table> <thead> <tr> <th>Параметр</th> <th>Тип</th> <th>Обязательно</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>countryId</code></td> <td>integer</td> <td>Да</td> <td>Идентификатор страны — возвращаются только города этой страны</td> </tr> </tbody> </table> <hr> <h2 id="особенности-запроса">Особенности запроса<a class="anchor" href="#%d0%be%d1%81%d0%be%d0%b1%d0%b5%d0%bd%d0%bd%d0%be%d1%81%d1%82%d0%b8-%d0%b7%d0%b0%d0%bf%d1%80%d0%be%d1%81%d0%b0">#</a></h2> <ul> <li><code>countryId</code> обязателен: без него или при нечисловом значении метод возвращает <code>400 Bad Request</code> без обращения к источнику данных.</li> <li>Несуществующий <code>countryId</code> (в т.ч. <code>0</code>) — это не ошибка, метод возвращает <code>200 OK</code> с пустым массивом.</li> </ul> <hr> <h2 id="примеры-запросов">Примеры запросов<a class="anchor" href="#%d0%bf%d1%80%d0%b8%d0%bc%d0%b5%d1%80%d1%8b-%d0%b7%d0%b0%d0%bf%d1%80%d0%be%d1%81%d0%be%d0%b2">#</a></h2> <h3 id="curl">cURL<a class="anchor" href="#curl">#</a></h3> <div class="highlight"><pre tabindex="0" style="background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">1</span><span>curl -X GET <span style="color:#a31515">&#34;https://test.travelplatform.ru/api/dictionary/cities?countryId=1&#34;</span> <span style="color:#a31515">\ </span></span></span><span style="display:flex;"><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">2</span><span><span style="color:#a31515"></span> -H <span style="color:#a31515">&#34;Authorization: Bearer &lt;token&gt;&#34;</span> <span style="color:#a31515">\ </span></span></span><span style="display:flex;"><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">3</span><span><span style="color:#a31515"></span> -H <span style="color:#a31515">&#34;Accept: application/json&#34;</span></span></span></code></pre></div>https://travelplatform.ru/docs/operations/dictionary/cities/response/Mon, 01 Jan 0001 00:00:00 +0000https://travelplatform.ru/docs/operations/dictionary/cities/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/dictionary/cities</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> <p>Тело ответа — массив верхнего уровня <code>City[]</code> (может быть пустым <code>[]</code>), отсортированный по <code>id</code> по возрастанию.</p> <h2 id="структура-city">Структура City<a class="anchor" href="#%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0-city">#</a></h2> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Обязательно</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>integer</td> <td>Да</td> <td>Идентификатор города</td> </tr> <tr> <td><code>nameRu</code></td> <td>string</td> <td>Да</td> <td>Название города на русском языке</td> </tr> <tr> <td><code>nameEn</code></td> <td>string</td> <td>Да</td> <td>Название города на английском языке</td> </tr> <tr> <td><code>latitude</code></td> <td>decimal</td> <td>Да</td> <td>Широта</td> </tr> <tr> <td><code>longitude</code></td> <td>decimal</td> <td>Да</td> <td>Долгота</td> </tr> <tr> <td><code>country</code></td> <td><a href="#%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%b0-country">Country</a></td> <td>Да</td> <td>Страна расположения города</td> </tr> </tbody> </table> <p>IATA-код города в ответе не возвращается — источник его не предоставляет без отдельного подзапроса на каждый город.</p>