- Можно ли вкладывать ресурсы rest в “каталоги”, которые указывают, что ресурсы имеют сходный тип, в отличие от указания иерархии принадлежности? – rest
- «Крайний раз»
- . «Ты с Ростова?»
- 13 фраз, которые не запрещены, но очень портят русский язык
- «Займи мне денег»
- «Оплата по карте»
- «Присаживайтесь»
- «Денежка», «человечек», «днюшка»
- «Закончил школу/университет»
- «Предоставленные неудобства»
- Другие результаты
Можно ли вкладывать ресурсы rest в “каталоги”, которые указывают, что ресурсы имеют сходный тип, в отличие от указания иерархии принадлежности? – rest
Учитывая, что у вас есть некоторые agents который может быть internal или же external:
- /agents/internal – ужасная идея, нарушающая согласованность URL
- /internal-agents – верная идея, но остерегайтесь недостатков
- Фильтр может быть лучше для этого варианта использования: GET /agents? Status=internal
/agents/internal – ужасная идея, нарушающая согласованность URL
Наличие /agents/internal – ужасная идея, ее НЕ ДОЛЖНО использовать, так как это приведет к несовместимым URL-адресам в вашем API, которые не будут легко понятны не только для людей, но и для программ.
- Лучший шаблон для REST URL (исключая вопросы о домене и управлении версиями):
/resources/{resouce id}/sub-resources/{sub-resource id}// Допускается не более 2 уровней. Ваш первый пример/companies/5/employeesэто идеальный хороший пример. - Добавление
/agents/internalURL сделает URL вашего API непоследовательными и трудными для понимания как людьми, так и программами. Вы можете закончить сGET /agents/2который возвращает агента с идентификатором 2, а такжеGET /agents/internalкоторые возвращают список внутренних агентов. Та же структура URL, но разные значения.
Использование согласованной структуры для URL помогает понять семантику, даже не зная, что делает API.
/internal-agents – верная идея, но остерегайтесь недостатков
Ваша идея иметь два конкретных ресурса internal-agents а также external-agents является действительным. Но это может иметь некоторые недостатки в зависимости от конкретного варианта использования:
- если вы добавите больше статуса, как
partnerнапример, вам придется добавить новый ресурсpartner-agents - если потребитель хочет получить оба типа, он должен будет сделать вызовы, или вам придется создать
/agentsресурс
Фильтр может быть лучше для этого варианта использования: GET /agents? Status=internal
Третья идея состоит в том, чтобы рассматривать внутреннее и внешнее в качестве фильтра для некоторого статуса на /agents ресурс.
GET /agentsвозвращает все агенты (внутренние внешние)GET /agents/2возвращает агента с идентификатором 2GET /agents?status=internalвозвращает агентов с внутренним статусомGET /agents?status=externalвозвращает агентов с внешним статусом
И если вы добавите новый статус, как partner:
GET /agentsвозвращает всех агентов (внутренний внешний новый статус партнера)GET /agents/2по-прежнему возвращает агента с идентификатором 2GET /agents?status=internalпо-прежнему возвращает агентов с внутренним статусомGET /agents?status=externalпо-прежнему возвращает агентов с внешним статусомGET /agents?status=partnerвозвращает агентов с новым статусом партнераGET /agents?status=internal,partnerвозвращает агентов с внутренним или партнерским статусом
Выбор между фильтром и конкретными ресурсами – это только показатель контекста.Единственное, что нужно иметь в виду, это обеспечить согласованность URL-адресов.
«Крайний раз»
В последнее время употребление слова «крайний» вместо прилагательного «последний» возросло в несколько раз. Всё дело в том, что люди видят в слове «последний» негативный оттенок. Практически никто не будет задавать вопрос «Кто последний в очереди?» или «Что ты делал в последний день недели?», но оправдана ли такая замена?
Слово «крайний» употребляли люди, чья профессия была связана с высоким риском для жизни, — летчики, альпинисты, подводники. Для людей этих специальностей слово «крайний», можно сказать, профессиональный сленг. Они старались исключить из своей речи слово «последний», чтобы их путешествие и правда не стало последним в жизни.
Но всем остальным филологи советуют не делать такую необоснованную замену и не бояться прилагательного «последний».
. «Ты с Ростова?»
Стоит отметить, что никаких претензий к городу мы не имеем — речь идет именно об употреблении предлога «с».
Запомни: предлог «в» употребляется как антоним предлогу «из», а предлог «на» — антоним «с». То есть если кто-то едет «в» Ростов, то возвращаться он будет «из» Ростова. По аналогии: если кто-то уехал «на» Камчатку, то приедет он «с» Камчатки.
13 фраз, которые не запрещены, но очень портят русский язык
Дело в том, что выражение «имеет место быть» — грамматически неправильное. Оно образовалось из-за неудачного сложения двух канцеляризмов – «имеет быть» и «имеет место». Чтобы говорить правильно, необходимо убрать слово «быть».
Русский глагол «является» – аналог английского to be. Его употребление в русском выглядит как плохой перевод с английского. И хотя это слово в русском языке практически не нужно, у него достаточно много поклонников. Достаточно сравнить – «Эта школа является лучшей в городе» и «Эта школа — лучшая в городе», чтобы понять, что и без несуразного «является» смысл сохраняется, а предложение выглядит куда более человечным.
Ещё один распространённый штамп, поработивший наш язык, пришёл из документов. Но только теперь его можно встретить чуть ли не в каждой статье, даже в переписках. «В данном случае» можно заменить на «в этом случае», а «в данном тексте допущена ошибка» написать «в этом тексте допущена ошибка». А лучше вообще обойтись без указательных слов: без них письменная речь выглядит чище.
Слово «касаемо» в русском языке есть, и его употребление не запрещено. Но эта форма считается устаревшей и просторечной. Вместо «касаемо» употребляем оборот «что касается» или «касательно».
«В настоящее время абонент не доступен» — первое, что приходит на ум. От этого выражения, если вы не автоответчик, лучше отказаться. Это слово вполне можно заменить наречием «сейчас», да и канцеляризмы никогда не украшали устную речь и тексты.
Слово «крайний» традиционно использовали в лексиконе люди, чья профессия была связана с риском для жизни. Космонавты, лётчики, альпинисты и подводники нарочито избегают слова «последний», опасаясь, чтобы «последний раз» действительно не стал последним. Их можно понять. Но в какой-то момент слово «крайний» стали употреблять все, кому не лень. Вот такая странная филологическая тенденция.
Итак, как же скучать правильно? В справочнике Розенталя можно встретить замечание о том, что с существительными и местоимениями третьего лица верно говорить: скучать по кому/чему. А вот в первом и втором лице будет «скучать по ком»: по нас, по вас. А вот «скучать за кем-то» или «скучать за чем-то» нельзя – такого словосочетания в русском языке нет.
В русском языке действительно есть глагол «порешать», но употребляться он может только в значении «решать в течение какого-то времени». Например, порешать задачу и бросить. Но сегодня всё чаше выражение «давай порешаем этот вопрос» используют в значении «решить вопрос». Так говорить неправильно. Это жаргонизм, как и «расскажи мне за него» в значении «расскажи мне о нём». В культурном обществе такие фразы употреблять не принято.
Ещё одна распространённая речевая ошибка – «оплатить за проезд». За проезд можно платить, а вот оплачивать только проезд – предлоги здесь недопустимы, поскольку по правилу при переходном глаголе предлог не нужен.
Пожалуй, каждый слышал» в качестве предложения занять сидячее положение неуклюжее «присаживайтесь». Почему-то слово «садитесь» ассоциируется с криминальным миром и тюрьмой. Но глагол «присесть» имеет конкретное лексическое значение – «опуститься на полусогнутых ногах» или «сесть на что-либо куда-либо на короткое время». Поэтому правильный вариант – «садитесь, пожалуйста». И только так.
Если необходимо попросить у кого-то денег взаймы, правильно сказать «можно занять у тебя денег?» или «одолжи мне денег». Но никак нельзя попросить у другого «занять» вам денег, так как «занять» – значит взять в займы. Иначе говоря, тем, кто просит «занять денег до зарплаты», вы точно ничего не должны.
Сегодня интернет-слег вышел за пределы Сети, а в интернет пришли не очень грамотные девочки, которые используют слова с уменьшительно-ласкательными суффиксами. «Человечек», «печалька», «вкусняшки», «винишко», «днюшечка» – дома, конечно, так разговаривать не запрещено, а вот в компании или на работе не стоит. Это слова находятся за пределами литературных норм.
И в продолжение темы 15 открыток о тонкостях русского языка, которые непросто понять иностранцам.
Понравилась статья? Тогда поддержи нас, жми:
«Займи мне денег»
Это словосочетание всем сердцем ненавидят те, кто понимает, как нужно говорить правильно. Если ты хочешь взять у кого-то деньги на определенный срок, то есть в долг, нужно сформулировать просьбу так: «Одолжи мне денег» или же «Можно занять у тебя денег?
12 самых длинных слов в разных языках мира
«Оплата по карте»
Похожая ситуация обстоит и с этой фразой — помнишь про переходный глагол «оплатить»? Так вот, здесь ему тоже не нужны предлоги. Ты же не говоришь «оплатить по деньгам»?
Попробуй задать проверочный вопрос: оплатить что? (товар, услугу, покупку), оплатить чем? (деньгами, бонусами, картой). Так что, если вдруг тебе захочется сказать «оплата по карте», вспомни эту небольшую подсказку.
«Присаживайтесь»
«Присаживайтесь» звучит неуклюже, хотя многие из нас даже не задумываются об этом. Просто однажды вдруг возникло негласное правило, что вместо «садитесь» следует употреблять глагол «присаживайтесь». Некоторые объясняют эту тенденцию тем, что слово «садитесь» будто бы вызывает тюремные ассоциации.
Если начать разбираться в значении глагола «присаживайтесь», можно выделить такие определения: присаживаться — значит опускаться на полусогнутых ногах или сесть куда-либо на короткое время (пример: присесть на дорожку). Так что твое предложение присесть собеседник может воспринять не как вежливый жест, а как попытку сократить разговор, быстрее выпроводить его откуда-либо. Запомни: если хочешь вежливо пригласить кого-то сесть — говори «садитесь».
«Денежка», «человечек», «днюшка»
А также «винишко», «печалька», «вкусняшка» и другие слова, над которыми знатно поиздевались, прежде чем сказать (написать) их. Это интернет-сленг, который стремительно выходит за пределы Сети. Взываем к твоему здравомыслию: у тебя есть возможность остановить всемирное помешательство на уменьшительно-ласкательных суффиксах!
Дома или в компании друзей используй эти слова в тех количествах, которые позволяют тебе поддерживать отношения с близкими. А вот в присутствии знакомых или коллег лучше воздержаться от этого. Литературный язык, конечно, дружелюбен, но уменьшительно-ласкательными формами слов злоупотреблять не стоит. Не переходи границы.
«Закончил школу/университет»
Так повелось, что школу, университет, техникум и другие образовательные организации «заканчивают». На деле же это одна из самых популярных ошибок, не более.
Глаголы «окончить» и «закончить» передают схожий смысл, но только в значении «доводить дело до конца, завершать что-либо». К примеру, ремонт можно и окончить, и закончить. Если же речь идет о завершении обучения, правильно будет говорить «окончил»: «окончил школу», «окончил курсы» и т. д. Если ты боишься запутаться, запомни, что выпускников поздравляют именно с окончанием чего-либо.
«Предоставленные неудобства»
«Приносим извинения за предоставленные неудобства» — слышал ли ты хоть раз в жизни эту фразу? Если да, то теперь ты знаешь, что мало просто извиниться — нужно еще и постараться сделать это грамотно.
Словосочетание «предоставленные неудобства» — это обыкновенная речевая ошибка, которую часто допускают из-за неверного употребления паронимов «доставить — предоставить».
Дело в том, что глагол «предоставить» имеет значение «дать какую-либо возможность». Можно предоставить какие-либо услуги или привилегии. Глагол «доставить» имеет сразу несколько значений: привезти/принести что-либо в определенный пункт («доставить пиццу») и оказать влияние на получение чего-либо («доставить неприятности»).
Неудобства нельзя предоставить. Правильно говорить: «Приносим извинения за доставленные (или причиненные) неудобства».
Другие результаты
Она уверена, что следует вкладывать средства в людские ресурсы, в частности развивать квалификацию персонала, занятого оказанием гуманитарной помощи, и высоко ценит усилия, предпринимаемые Управлением Верховного комиссара в этой области, в частности при посредстве Центра ЧС в Токио.
Например, государствам-донорам не следует вкладывать средства в укрепление систем здравоохранения, предписывая или разрешая частным субъектам, находящимся под их юрисдикцией, отвлекать людские ресурсы на цели политики в области миграции.
