Одностоечная опора: Одностоечная опора — Большая Энциклопедия Нефти и Газа, статья, страница 1

Содержание

Одностоечная опора — Большая Энциклопедия Нефти и Газа, статья, страница 1

Одностоечная опора

Cтраница 1

Одностоечные опоры применяют в качестве промежуточных, а одностоечные с подкосом и А-образные — в качестве угловых, анкерных и концевых.
 [1]

Одностоечные опоры с фундаментами или с оттяжками устанавливают также краном и трактором. До начала подъема стойки опор, устанавливаемых на фундаментах, соединяют с фундаментами шарнирами, вокруг которых вращают опору при подъеме. Торможение низа опоры в этом случае не требуется. К стойкам опор, устанавливаемых с оттяжками, оттяжки присоединяют до подъема. Анкерные плиты для закрепления оттяжек также монтируют заранее.
 [2]

Одностоечные опоры массой до 4 т устанавливают краном, до 10 т — краном и трактором, более 10 т — падающей стрелой и тракторами. Портальные опоры почти всех конструкций устанавливают падающей стрелой и тракторами. Иногда металлические опоры устанавливают вертолетом.
 [3]

Одностоечные опоры допускается поднимать вручную, при этом снимать поддерживающие багры и ухваты разрешается только после установки опоры и полной засыпки котлована землей. Багры и ухваты должны быть длиной 2 5 — 4 5 м и диаметром не менее 50 мм и иметь прочные металлические наконечники.
 [4]

Одностоечные опоры с фундаментами или с оттяжками устанавливают также краном и трактором. До начала подъема стойки опор, устанавливаемых на фундаментах, соединяют с фундаментами шарнирами, вокруг которых вращают опору при подъеме. Торможение низа опоры в этом случае не требуется. К стойкам опор, устанавливаемых с оттяжками, вттяжки присоединяют до подъема. Анкерные плиты для закрепления оттяжек также монтируют заранее.
 [5]

Одностоечные опоры массой до 4 г устанавливают крапом, до 10 т — краном и трактором, свыше 10 т — падающей стрелой и тракторами. Портальные опоры почти всех конструкций устанавливают падающей стрелой и тракторами. Иногда металлические опоры устанавливают вертолетом.
 [6]

Одностоечные опоры допускается поднимать вручную баграми и ухватами, при этом снимать поддерживающие багры и ухваты разрешается только после установки опоры и полной засыпки котлована землей. Багры и ухваты должны быть длиной 2 5 — 4 5 м и диаметром не менее 50 мм и оборудованы прочными металлическими наконечниками.
 [7]

Одностоечная опора — Большая Энциклопедия Нефти и Газа, статья, страница 3

Одностоечная опора

Cтраница 3

Для одностоечных опор, у которых нижний конец стойки заделывается в грунт, фундаментом служит низ стойки; для металлических опор применяются свайные или сборные грибовидные железобетонные ( рис. 2 — 3 — 2 — 11), усиленные в необходимых случаях ригелями и пригрузочными плитами, а при установке переходных опор и опор на болотах — монолитные бетонные фундаменты.
 [31]

Стойки одностоечных опор должны поступать с завода с установленными нижними крышками, с нанесенной гидроизоляцией и установленным заземлителем.
 [32]

Для одностоечной опоры применим упрощенный метод расчета. Он заключается в том, что дополнительное напряжение в материале оперы, вызванное вертикальными силами веса опоры, изоляторов и проводов и прогибом опоры, учитывается увеличением изгибающего момента от давления ветра на провода и опору.
 [33]

Для одностоечной опоры на прямолинейном участке трассы котлован длинной частью располагается вдоль трассы. При разбивке котлованов под угловую А-образную опору предварительно следует угол поворота трассы разделить пополам. Для этого, приняв столб за вершину ( рис. 116), откладывают по направлению обеих сторон угла равные отрезки аЬ и ас. Затем соединяют точки Ъ и с, а середину отрезка be соединяют с точкой а. Прямая ad и будет биссектрисой угла. Котлованы будут находиться на этой биссектрисе и будут отдалены от точки а на одинаковые расстояния. Углы поворота линии обозначают угловыми знаками.
 [35]

Для одностоечных опор, у которых нижний конец стойки заделывается в грунт, фундаментом служит низ стойки; для металлических опор применяются свайные или сборные грибовидные железобетонные ( рис. 2 — 3 — 2 — 11), а при установке переходных опор и опор на болотах — монолитные бетонные фундаменты.
 [37]

Стойки одностоечных опор должны поступать с завода с установленными нижними крышками, с нанесенной гидроизоляцией и установленным заземлителем.
 [39]

Сборка одностоечных опор сводится к навешиванию траверс на стойку, прикреплению их к стойке болтами и укреплению ригелей.
 [41]

Промежуточные металлические опоры ВЛ 110кВ типа ПС110, П110

Производство стальных одно- и двухцепных промежуточных опор ВЛ напряжением 110кВ осуществляется по типовой проектной документации института «Энергосетьпроект». В настоящий момент для реконструкции и даже нового строительства ВЛЭП до сих пор широко используют нормальные и специальные опорные конструкции, разработанные еще в прошлом веке. Нормальные одноцепные опоры с маркировкой П110-1, П110-3, П110-3У, П110-5, П110-5ПГ и двухцепные опоры П110-2, П110-4, П110-4У, П110-6, П110-6ПГ, а так же пониженные опоры с уменьшенной по высоте нижней секцией ПС110-3, ПС110-5, ПС110-4, ПС110-6 выполняются в виде одностоечных свободностоящих конструкций по рабочим чертежам альбома № 3078тм-том9. По чертежам этого же альбома изготавливают нормальные и пониженные опоры на оттяжках П110-7, ПС110-7.

Подставки повышенных опор П110-1+4, П110-3+4, П110-5+4, П110-2+4, П110-4+4, П110-6+4 выполняются по рабочим чертежам альбома № 3079тм-том4.

Изготовление специальной опоры на оттяжках ПС110-11 и свободностоящих опор ПУС110-1, ПУС110-2, ПС110-9, ПС110-10, ПС110-10+1,3 для использования в горных районах осуществляется в соответствии с чертежами и требованиями проекта № 3079тм-том6. Проектом разработаны тросостойки плавки гололеда к соответствующим опорам ПС110-9ПГ, ПС110-10ПГ, ПС110-11ПГ.

Специальная узкобазная стальная опора, рассчитанная на применение в городских условиях ПС110-13 разработана и выпускается согласно проекта № 3079тм-том5.

В настоящее время, взамен опор, указанных проектов, разработаны и изготавливаются нормальные опоры первого и второго региона применения 1.2П110-1, 1П110-2, 1.2П110-3, 1П110-4, 1П110-6, и соответствующие различные варианты пониженных опор 1.2П110-1-3,2, 1,2П110-1-3,6, 1.2П110-1-8,5, 1П110-2-3,2, 1П110-2-8,5, 1.2П110-3-3,2, 1.2П110-3-3,6, 1.2П110-3-8,5, 1П110-4-3,2, 1П110-4-8,5, 1П110-6-3,2, 1П110-6-8,5 по чертежам типовой серии 3.407.2-170 выпуск 1, 2.

Опоры третьего региона применения 3П110-1, 3П110-2, 3П110-3 для эксплуатации в районах с загрязненной атмосферой, и различные варианты пониженных нижних секций опор 3П110-1-3,2, 3П110-1-8,5, 3П110-2-3,2, 3П110-2-8,5, 3П110-3-3,2, 3П110-3-8,5 производятся по чертежам типовой серии 3. 407.2-156 выпуск 1. Базы и геометрические схемы нижней части ствола аналогичны соответствующим опорам первого региона применения.

Одностоечные промежуточные опоры на оттяжках второго климатического региона применения выпускаются в соответствии с типовым проектом 3.407.2-165 в нескольких вариантах исполнения: нормальной высоты 2П110-11, пониженные 2П110-11-5,4, 2П110-11-10,8, повышенные 2П110-11+5,4.

Тросостойки плавки гололеда для опор различных регионов применения 3П110-1ПГ, 1.3П110-2ПГ, 3П110-3ПГ, 1П110-4ПГ, 1П110-6ПГ, 2П110-11ПГ и консоли изолированной подвески грозозащитного троса на опорах 1.2П110-1ПГ, 1.2П110-3ПГ выпускаются по чертежам типовой серии 3.407.2-166 выпуск 2.

Для работы в экстремальных гололедно-ветровых условиях при толщинах стенки гололеда до 40 мм и скорости ветра до 50 м/с разработаны опорные конструкции ЛЭП для Крайнего Севера. Свободностоящая одностоечная опора ПВ110-3 и портальная опора с оттяжками ПВ110-9 выполняются по рабочим чертежам проекта № 7079тм-том12. Устанавливать, указанные опоры, в вечномерзлых грунтах предлагается на свайно-винтовом фундаменте.

Нецинкуемые свободностоящие опоры П110-1Н, П110-2Н, П110-3Н, П110-4Н, П110-5Н, П110-6Н, ПС110-3Н, ПС110-4Н, ПС110-5Н, ПС110-6Н, ПС110-9Н, ПС110-10Н, ПС110-13Н и нецинкуемые опоры с оттяжками П110-7Н, ПС110-7Н, ПС110-11Н выполняются по рабочим чертежам альбома № 5778тм-том3.

Опоры с болтовыми секциями с маркировкой П110-1В, П110-2В, П110-3В, П110-3ВУ, П110-4В, П110-4ВУ, П110-5В, П110-5ВПГ, П110-6В, П110-6ВПГ, ПС110-5В, ПС110-6В, ПС110-9В, ПС110-10В, ПС110-10В+1,3, ПС110-9ВПГ, ПС110-10ВПГ и подставки повышенных опор П110-1В+4, П110-2В+4, П110-3В+4, П110-4В+4, П110-5В+4, П110-6В+4 представлены и выпускаются по чертежам альбома № 11520тм-том1.

Перечисленные промежуточные опоры находят применение при строительстве ВЛ 110кВ с различными гололедно-ветровыми нагрузками, и монтируются в стандартных и слабых минеральных грунтах, на унифицированные свайные, свайно-винтовые и грибовидные фундаменты. Часто, представленные в этом разделе каталога, опоры используют, вместо промежуточных опор ВЛ 35кВ, как правило для последующей модернизации ЛЭП в сторону увеличения рабочего напряжения.

Цена на нормальные стальные опоры ЛЭП зависит от марки стали и антикоррозионного покрытия конструкций.Узнать цену опор ВЛ

КЛАССИФИКАЦИЯ ОПОР ЛЭП ПО ОБЩЕМУ ВИДУ: novoklimov — LiveJournal

Класс: «Башенные решётчатые опоры»
Классические, самые распространенные из всех опор ЛЭП высокого напряжения. Могут иметь от одного до 9-ти параллельных траверс, и применятся для одно- двух- или многоцепных ЛЭП. Все башенные опоры решётчатые объединяет общая черта – их ствол сужается от базы к верхушке. Подразделяются на два семейства:
-Широкоствольные решётчатые (если основание мачты шире товарного вагона,). Это самые распространенные опоры. Могут быть одноцепными («Крымского типа»), двухцепные (типа «Бочка») и многоцепные («комби»)

Узкоствольные решётчатые (соответственно их основание уже товарного вагона). Класс: «Портальные опоры»
Семейство: Ортопортальные
Опоры из металла, дерева или железобетона (см. также семейство «П-образные столбовые»), напоминающие букву «П» либо букву «Н», имеющие два основания и общий траверс(ы). Пользуются особо широким распространением на ЛЭП 330-750 кВ. Как правило, одноцепные.

Семейство: Метапортальные опоры
Анкеры, иногда напоминающие букву «m». От обычных ортопопортальных отличаются тем, что имеют более двух оснований. Самая широкая разновидность метапортальных опор – подстанционные порталы (офиц. термин) – это конструкции, устанавливаемые перед началом линий, на электроподстанциях.

Семейство: Протопортальные
Зачастую это архаичные, одноцепные опоры, у которых портал ещё окончательно не сформировался. Имеется сросток между стенками портала. Применялись с 30-х годов. Для некоторых таких опор характерно подобие двух букв «Х» стоящих друг на друге, если смотреть на мачту в анфас. Типичные представители – анкер АС и опоры «Свирского типа» (30-е годы), специальная опора АС-40В и т.п.
Класс: «АП-образные опоры»Одноцепные опоры, созданные при помощи сварных металлических труб, МГС либо дерева, в профиль напоминающие букву «А», в анфас букву «П». Сечение труб в этих опорах может достигать 1300 мм, а высота может быть свыше 80 м. На фото пример такой трубчатой опоры при переходе линии 330кВ через Днепр, на Украине. Внутри её стоек, находятся лестницы для подъёма на вершину, а всего опора имеет четыре колена высотой 21 метр каждый (они окрашены в разные цвета), общая высота мачты около 85 метров. Подробнее можно прочитать тут — http://io.ua/s93360.

Класс: «Пирамидальные опоры»
(офиц. термин — трехстоечные раздельностоящие решётчатые опоры)
Трёхстоечные решётчатые опоры, как правило, стоят на поворотах и переходах ЛЭП 500кВ и 750кВ, используются в качестве анкерных (фото).


Класс: «Л-образные (качающиеся) опоры»
Представляют собой плоские Л-образные решётчатые конструкции, шарнирно сочленённые с двумя фундаментами. Наверху опоры – траверса для крепления 4-х несущих тросов, удерживающих опору в вертикальном положении. Ниже расположены ещё три (реже две) траверсы, для подвеса проводов. Л-образные вышки применялись, в частности, как переходные для двух цепей ВЛ 110кВ или 220 кВ. Их применение позволило сэкономить металл и упростить фундамент. Такие опоры было целесообразно применять в заливаемых водою территориях при половодье. Особенности конструкции не дали этим опорам получить широкое распространение.

Класс: «Y-образные опоры» («рюмки»)
Одноцепные мачты напоминающие букву «Y» или рюмку. Существуют разных типов и применяются достаточно давно и у нас и заграницей, в том числе в качестве переходных (например, ПС-101). Всегда выполнены из металла, обычно решётчатые, реже состоят из многогранных гнутых стоек.

Класс: «Дельтавидные опоры»
Одноцепные решётчатые опоры, всегда имеющие широкую базу, а верхушкой они напоминает Y-образные мачты. Широко распространены на Западе (особенно в США). На фото пример дельтавидной опоры ЛЭП в Швейцарии, с железобетонными антилавинными «штанами».

Класс: «Столбовые опоры» (т.е. не решётчатые)
Это опоры, в основе которых деревянные, металлические либо железобетонные столбы. Существуют одностоечные и портальные.
Семейство: Одностоечные столбовые опоры
Одностоечные опоры из железобетона – самые широко распространенные промежуточные опоры ЛЭП на напряжениях 35-220 кВ. Относительно недавно получил распространение прогрессивный тип металлических одностоечных столбовых опор – с применением МГС. Если говорить точнее, то в США такие опоры применяются довольно давно, а в СНГ они только начинают завоёвывать популярность. Применение МГС позволило создавать столбовые многоцепные опоры.

Семейство – Портальные (П-образные) столбовые
Портальные столбовые опоры состоят из двух столбов (деревянных, железобетонных или МГС) скреплённых общей траверсой. Особое распространение у нас получили столбовые одноцепные портальные ж-б опоры ПВС для линий 220 и 330 кВ. Разновидность портальных столбовых опор – «высоковольтные ворота» (опоры с ригелем из железобетона). Часто они имеют более двух стоек в основании и используются в качестве подстанционных порталов.

Семейство – Раздельностоящие столбовые
В отличие от портальных столбовых, не скреплены общей траверсой. Каждая из этих опор поддерживает лишь одну фазу ЛЭП, встречаются редко, в основном на 500кВ.


Класс: V-образные
Промежуточные поры с оттяжками, применяемы на трассах ЛЭП 330-1150кВ, к примеру, опоры типа «Набла» для 750 кВ. Напоминают перевернутый треугольник — наблу. Исключительно одноцепные.

Класс: Опоры типа «Кошка»
Весьма интересные оригинальные опоры, пользуются большой популярности в странах западной Европы, особенно во Франции.

Нестандартные опоры
К ним относятся различные не классифицируемые выше, нестандартные опоры и экзотика, например многочисленные декоративные опоры. Это очень обширная тема, поэтому требует отдельного описания.

Надеюсь, эта подборка заинтересует вас этой темой).
Если заинтересовала, то добро пожаловать на фотогалерею ЛЭП «PowerLiner» www.novoklimov.io.ua Тут вы сможете увидеть более 2300 фото снимков ЛЭП и подстанций России и Украины.
Буду также рад видеть Вас на своём блоге, посвящённом хайвольтаж-трэвеллингу
www.novoklimov.blogspot.com
 

Типы опор для абонентского отвода

Вступление

Обычно, абонентские опоры, опоры между ВЛИ и домом, выполняют функцию, поддерживающих (промежуточных) опор. Для крайних домов, в конце магистрали или линейного отвода, опора абонентского отвода может быть анкерной (угловой или конечной).

Уральский завод многогранных опор опор выпускает широкий ассортимент многогранных опор. В ассортименте опоры ЛЭП и освещения, высоко мачтовые опоры, трубчатые опоры невысоких нагрузок.

Обычно частный дом стоит в поселке, товариществе или деревне. Считаем, что по населенному пункту проложена магистраль линии электропередачи. Напряжение линии электропередачи магистрали 0,4 кВ, то есть относится, к классификации ЛЭП до 1 кВ. Для таких линий электропередачи (магистралей или линейных отводов) применяются деревянные или железобетонные опоры.

Для абонентского отвода (ответвление к дому) расположенному далее 50 метров от магистрали или расположенного с противоположенной стороны дороги от магистрали необходима установка промежуточной опоры, по типу аналогичной опорам магистрали, то есть деревянная или железобетонная.

Типы опор для абонентского отвода – описание и характеристики

Деревянные опоры линий электропередачи

Для ЛЭП и ВЛИ до 1 кВ, используются деревянные опоры одностоечные или одностоечные с подкосом или А-образные. Чаще деревянная опора монтируется вместе с железобетонным пасынком. Пасынок это короткий бетонный столб, который вкапывается в землю, а деревянная опора прикручивается к нему стальной проволокой 8-10-12 мм, в двух местах.

типы опор для абонентского отвода

Для абонентского отвода к дому используется промежуточная одностоечная опора или одностоечная деревянная опора с подкосом, если опора является угловой или оконечной.

Железобетонные опоры

Железобетонные опоры по типу конструкции аналогичны деревянным: одностоечные, одностоечные с подкосом, А-образные или рамные П-образные.

Бетонные опоры для линий электропередачи 10 кВ. Обозначения: П -промежуточная, УА-угловая анкерная, ОА- оконечная анкерная.

 Для абонентского отвода к дому используется промежуточная одностоечная бетонная опора или одностоечная бетонная опора с подкосом, если опора получается угловой (при повороте отвода).

По форме бетонные опоры чаще делают с квадратным (прямоугольным) сечением. Марки СВ-95-2, СВ-110. Изготовляются методом вибрирования.

Выпускаются цилиндрические и цилиндрические конусообразные опоры. Они изготавливаются методом центробежного уплотнения и называются центрифугированными.

Для абонентского отвода к дому, использовать мощные цилиндрические опоры лишнее. Достаточно прямоугольной бетонной опоры типа СВ-95-2 (промежуточной) или СВ-110 (анкерно-угловой).

Важно! При покупке такой опоры нужно обратить особое внимание на наличие заземляющего спуска сделанного внутри опоры и наличие выводов этого спуска верху и внизу опоры.

Установка опор абонентского отвода своими руками

Подробно, о монтаже опор для отвода к частному дому в следующей статье. Здесь только замечу, что и деревянные и железобетонные опоры устанавливаются без фундамента в заранее подготовленный цилиндрический котлован диаметром больше на 10 см диаметра опоры.

Яма для установки опоры

©Ehto.ru

Другие статьи раздела: Электрика частного дома

Похожие посты:

Установка бетонной опоры линий электропередачи

Вступление

Если ваш загородный дом отстоит от магистрали или линейного отвода ВЛИ дальше 50 метров, придется устанавливать промежуточную опору для поддержания провода абонентского отключения. Устанавливается такая опора, обычно, за счет собственника. В видео этой статьи посмотрим, как ставится бетонная опора линии электропередачи в загородном поселке.

Под загородным поселком (в этой статье) понимаем любое юридически оформленное объединение домов с магистральным электропитанием 0,4 кВ от понижающего трансформатора 10/0,4 кВ, выполненного воздушным способом изолированным самонесущим проводом (СИП).

Варианты исполнения промежуточных опор ВЛИ

Для промежуточной опоры абонентского отвода, разумно использовать железобетонную опору, марки СБ 95-110. Если такая опора изготовлена согласно технологии, то прослужит долгие годы. По конструкции столбы марки СБ имеют внутреннюю шину заземления, а отводы заземления выведены в верху и внизу столба. Это облегчает монтаж повторного заземления ВЛИ.

Промежуточная пора предназначена для подержания провода ВЛИ и не испытывает нагрузки от тяжения провода. Поэтому, конструкция промежуточной опоры одностоечная, то есть это один столб без поддерживающих стоек.

Установка бетонной опоры линий электропередачи — общая технология установки

Промежуточная бетонная опора устанавливается по следующей технологии

Для работ нанимается бригада с бурово-крановой установкой. Бригада должна иметь наряд на работы;

Заказчик обеспечивает доступ к месту работы и проезд техники;

Опора привозится на место установки заранее и укладывается вдоль линии отвода. Центр тяжести опоры должен находиться в 1,5 метрах от ямы для опоры;

Буром делается отверстие под опору. Глубина ямы для СБ 95 абонентского отвода, должна быть 1500 мм, ширина больше размера столба на 10 см с каждой стороны;

Длина опоры, метр7,5-8,58,5-9,511-13
Глубина ямы, метр1,41,51,6

После механического бурения производится ручная очистка краев ямы;

Бур машины убирается и включается в работу её кран;

К верху опоры на расстоянии 50 см от верха монтируется кронштейн для крепления промежуточного подвеса. В принципе эти работы могут проводится на установленной опоре;

Готовую опору, обхватывают стропой выше центра тяжести. Выше и ниже зацепа, можно закрепить страховочные канаты;

Опору поднимают на 20-30 см от земли и руками направляют в яму. Страховочные канаты удерживают опору от раскачивания;

Конец опоры вставляют в яму и выравнивают по вертикали, краном и страховочными канатами. Если кронштейн с поддерживающим зажимом монтировался заранее, нужно соблюсти его правильное расположение по направлению прокладки провода;

Яму вокруг опоры засыпают и трамбуют;

После трамбовки отцепляют стропы и канаты.

Видео статьи: Установка бетонной промежуточной опоры ВЛИ

Вывод

Как видите, Установка бетонной опоры линий электропередачи с применение спецтехники не так сложна, однако требует навыков.

©Ehto.ru

Другие видео статьи

Похожие посты:

Форматы сообщений — Поддержка — WordPress.com

Academica Aside, Gallery
Adaption Aside, Audio, Chat, Gallery, Image, Link, Quote, Status, Video
Adelle В сторону, Аудио, Чат, Галерея, Ссылка, Изображение, Цитата, Статус, Видео
Albeo В сторону, Изображение, Видео, Цитата, Ссылка
Альбом Видео, Изображение, Аудио
Альт В сторону, Изображение, Видео, Цитата, Ссылка
Амперсанд В сторону, Изображение, Видео, Цитата, Ссылка
Анемон В сторону, Аудио, Галерея, Изображение, Ссылка, Цитата, Видео
Апостроф В сторону, Аудио, Чат, Галерея, Ссылка, Изображение, Цитата, Статус, Видео
Аркада В сторону, Аудио, Галерея, Ссылка, Изображение, Цитата, Статус, Видео
Атлас А udio, Галерея, Изображение, Ссылка, Цитата, Видео
Atrium Галерея, Изображение, Видео
Axon В сторону, Аудио, Галерея, Изображение, Ссылка, Цитата, Видео
Avid Галерея, изображение, ссылка, цитата, видео
Превосходно Галерея, изображение, в сторону, цитата, видео
Baskerville в сторону, аудио, чат, галерея, изображение, ссылка, цитата, статус, видео
Baskerville 2 В сторону, Аудио, Чат, Галерея, Изображение, Ссылка, Цитата, Статус, Видео
Пляж В сторону, Галерея, Цитата, Статус
Большой Брат В сторону, Изображение, Видео, цитата, ссылка
Blocco Видео
Blogly Аудио, в стороне, чат, галерея, изображение, ссылка, видео, цитата, статус
Blogum
005 в сторону, галерея, изображение

Галерея, видео

9000 4 Аудио, Чат, Галерея, Изображение, Ссылка, Цитата, Видео

9 0008

В сторону, Изображение, Видео, Цитата, Ссылка, Галерея

Singl

90 004 Видео

Boardwalk В сторону, Изображение, Видео, Цитата, Ссылка, Чат, Галерея
Bon Vivant В сторону, Изображение, Видео, Цитата, Ссылка
Book Lite В сторону, Изображение, Видео, Цитата, Ссылка
Bosco В сторону, Аудио, Изображение, Ссылка, Цитата, Видео
Букет В сторону, Галерея, Изображение
Бриджер Аудио, Галерея, Изображение, Видео

Bueno В сторону, Изображение, Видео, Цитата, Ссылка
Кнопка В сторону, Изображение, Видео, Цитата, Ссылка, Галерея
Caldwell В сторону, Цитата, Ссылка
Камера Галерея
Canard Изображение, ссылка, галерея
Candela В сторону, аудио, галерея, изображение, ссылка, цитата, видео
Capoverso Asi de, Изображение, Видео, Ссылка, Цитата
Цельсия В сторону, Изображение, Видео, Ссылка, Цитата, Галерея
Мел В сторону, Аудио, Чат, Галерея, Ссылка, Цитата, Статус, Видео
Классная доска В сторону, Изображение, Видео, Цитата, Ссылка
Шато В сторону, Изображение, Видео, Цитата, Ссылка, Галерея
Choco В сторону, Изображение, Видео, Цитата, Ссылка
Chunk В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Аудио, Чат
Около В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Статус, Аудио
Clear News Аудио, Галерея, Изображение, Видео
Какао В сторону, Ссылка, Цитата, Статус, Видео, Изображение
Связное В сторону
Коллекции В сторону, Изображение, Галерея, Ссылка, Цитата , Аудио, видео o
Cols В сторону, Изображение, Видео, Цитата, Ссылка, Чат, Аудио
Connect Галерея, Ссылка, Изображение, Аудио, Статус, Цитата, Видео
Coraline В сторону, Изображение, видео, цитата, ссылка, галерея
Corporate В сторону, аудио, чат, галерея, изображение, ссылка, цитата, статус, видео
Crafty в сторону, изображение, ссылка, цитата, видео
Creative Статус, изображение, видео, цитата, чат, аудио
Creative Portfolio В стороне, чат, галерея, ссылка, изображение, цитата, статус, видео, аудио
Crisp Image , Ссылка, Цитата, Видео, Аудио, В сторону, Галерея, Статус
Cubic В сторону, Изображение, Видео, Цитата, Ссылка, Чат, Галерея
Куратор В сторону, Аудио, Галерея, Изображение, Ссылка , Цитата, видео
Дебют Аудио, Галерея, Изображение, Видео
Спрос Изображение, Видео
Дикот В сторону, Аудио, Галерея, Изображение, Ссылка, Цитата, Видео
Duet Image
От заката до рассвета В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Чат, Аудио
Duster В сторону, Галерея, Ссылка
Dyad Изображение

Ecto В сторону, Изображение, Видео, Цитата, Ссылка
Edda В сторону, Изображение, Видео, Цитата, Ссылка, Аудио, Чат, Галерея, Статус
Edin В сторону, Изображение, Видео, Цитата, ссылка, статус
Редактор В сторону, Изображение, Видео, Цитата, Ссылка
Восьмидесятые В сторону, Изображение, Видео, Цитата, Ссылка, Аудио, Галерея, Статус
Elemin 900 05

 В сторону, Галерея, Ссылка, Изображение, Цитата, Аудио, Статус, Видео, Чат
Espied В сторону, Изображение, Видео, Цитата, Ссылка, Галерея
Espresso В сторону, Изображение, Видео, Цитата, ссылка
Ever After Галерея, изображение, статус, цитата
Everyday В сторону, Галерея, изображение, статус, цитата
Fanwood Light В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Статус, Чат
Фиктивная В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Статус
Fiore В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Статус, Чат
Флора и фауна В стороне, Изображение, Видео, Цитата, Ссылка, Галерея, Статус
Камбала В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Статус
Шрифт В сторону, Изображение, видео, цитата , Ссылка, Галерея
Forefront В сторону, Изображение, Видео, Цитата, Ссылка
Forever Галерея, Изображение, Статус, Цитата
Франклин В сторону, Изображение, Ссылка, Цитата, Видео
Fruit Shake В сторону, Галерея, Изображение, Цитата, Ссылка, Статус
Далее В сторону, Галерея, Изображение, Цитата, Ссылка, Видео
Галерея В сторону, Аудио, Видео, Изображение, ссылка, цитата, статус, галерея
Gazette Image, Video, Link, Gallery
Gigawatt Video, Image
Goran Aside, Image, Video, Quote, Link, Статус
Серый В сторону, изображение, видео, цитата, ссылка
Gridspace Аудио, чат, галерея, изображение, ссылка, цитата, видео
Harmonic
Hemingway Rewritten В сторону, Аудио, Чат, Галерея, Изображение, Ссылка, Цитата, Статус, Видео
Hew В сторону, Изображение, Видео, Цитата, Ссылка, Галерея
Hexa В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Статус, Аудио
Highwind В сторону, Изображение, Видео, Цитата, Ссылка, Галерея
Huesos Link, Quote
Hum Aside, Gallery, Image, Link, Status, Quote
Huntt Image, Video, Quote, Gallery, Link
Hustle Express

 Aside , Изображение, видео, цитата, ссылка, чат
Hyalite в сторону, аудио, чат, галерея, изображение, ссылка, цитата, статус, видео
Illustratr в сторону, аудио, галерея, изображение, ссылка , Цитата, Статус, Видео
Независимый издатель В сторону, Изображение, Ссылка, Цитата, Видео
Лаборатория Вдохновения В сторону, Изображение, Видео, Цитата, Ссылка, Аудио, Галерея
Межгалактический В сторону, Изображение, Видео, Цитата, ссылка, галерея
Isca В сторону, чат, галерея, изображение, ссылка, цитата, видео
Isola в сторону, изображение, видео, цитата, ссылка, галерея
iTheme2
Джейсон В сторону, Изображение, Видео, Ссылка, Цитата
Just Desserts Галерея, Изображение
Келли В сторону, Изображение, Видео , Цитата, Ссылка, Галерея
Kiore Moana В сторону, Чат, Изображение, Видео, Цитата, Ссылка, Галерея, Статус
Кои В сторону, Изображение, Видео, Цитата, Ссылка
Либретто В сторону, Аудио, Чат, Галерея, Ссылка, Изображение, Цитата, Статус, Видео
Lingonberry В сторону, Изображение, Видео, Цитата, Ссылка, Аудио, Чат, Галерея, Статус
Liquorice В сторону, Галерея, Изображение, Цитата
Маленькая история В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Статус
Lovebirds Галерея, Изображение, Статус, Цитата
Lovecraft В сторону
Lyretail В сторону, Изображение, Видео, Цитата, Ссылка
Magnate Express В сторону, Изображение, Видео, Цитата, Ссылка, Чат
Maisha В сторону , Галерея, Изображение, Ссылка, Цитата, Статус, Видео
Манифест В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Статус
Matala В сторону, Изображение, Видео, Цитата, Ссылка, G allery, Статус
McKinley В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Статус
Мина Олен В сторону, Аудио, Чат, Изображение, Галерея, Статус, Видео, Цитата, Ссылка
Minimalizine В сторону, изображение, видео, цитата, ссылка
Minnow в сторону, изображение, видео, цитата, ссылка, аудио, галерея, статус
Mixfolio Галерея, изображение, ссылка, цитата , Видео
Modularity Lite В сторону, Изображение, Видео, Цитата, Ссылка
Moka Галерея, Изображение, Ссылка, Цитата
Monet В сторону, Аудио, Видео, Ссылка, Цитата
Monster В сторону
Motif В сторону, Галерея, Изображение, Ссылка, Цитата, Видео
Движение В сторону, Изображение, Видео, Цитата, Ссылка
Музей 90 005

 В сторону, Изображение, Видео, Аудио, Цитата, Ссылка
Моя жизнь В сторону, Изображение, Видео, Цитата, Ссылка, Аудио, Галерея, Статус
Mystique В сторону, Изображение, Видео, Цитата , Ссылка, Галерея
В следующую субботу В сторону, Аудио, Чат, Галерея, Изображение, Ссылка, Цитата, Видео
Nowell В сторону, Аудио, Изображение, Ссылка, Цитата, Видео
Nucleare В сторону, Изображение, Видео, Цитата, Ссылка, Аудио, Галерея
По прихоти В сторону, Изображение, Видео, Цитата, Ссылка, Галерея
По запросу Видео
Откровенное Видео, Галерея, Изображение, Аудио
Pachyderm В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Статус, Чат
Панель В сторону, Изображение, Видео, Цитата, Ссылка
Патч А сторона, Галерея, Изображение, Аудио, Видео, Цитата, Ссылка
Penscratch В сторону, Изображение, Видео, Цитата, Ссылка
Photolia Аудио, Галерея, Статус, Чат, В сторону, Изображение, Видео, Цитата, ссылка
Pictorico В сторону, изображение, видео, цитата, ссылка, галерея, аудио
Pilcrow В сторону, изображение, видео, цитата, ссылка
Доска В сторону 9000

 Pink Touch 2 В сторону, Аудио, Чат, Галерея, Изображение, Ссылка, Цитата, Видео
Pique В сторону, Аудио, Чат, Галерея, Ссылка, Изображение, Цитата, Статус, Видео
Плоскость В сторону, Изображение, Ссылка, Цитата, Видео
Поли В сторону, Аудио, Галерея, Изображение, Ссылка, Цитата, Видео
Опубликовать В сторону, Чат, Галерея, Изображение, Ссылка, Цитата, Статус, видео
Издатель Image, Quote
Purpose Gallery, Link, Image, Audio, Status, Quote, Video
Qua Video
Quadra Aside, Image, Video, Quote , Галерея, Статус, Аудио
Quintus В сторону, Ссылка, Цитата
Radcliffe В сторону, Изображение, Видео, Цитата, Ссылка
React Галерея , Изображение
Runo Lite Галерея, изображение, цитата
Revelar Галерея, изображение, видео, цитата, ссылка
Rowling Галерея
Aside, Rusty

 Галерея Rusty , Цитата, Статус
Ryu В сторону, Галерея, Изображение, Ссылка, Цитата, Видео
Сага В сторону, Изображение, Видео, Qu ote, Ссылка, Аудио, Чат, Галерея, Статус
San Kloud В сторону, Галерея, Изображение, Цитата, Ссылка, Чат, Аудио, Видео, Статус
Sapor В сторону, Изображение, Видео, Цитата , Ссылка, Аудио, Чат, Галерея, Статус
Спутник В сторону, Изображение, Видео, Цитата, Ссылка, Аудио, Чат, Галерея, Статус
Блокнот В сторону, Изображение, Видео, Цитата, Ссылка , Аудио, Галерея, Статус
Прокрутка В сторону, Изображение, Видео, Цитата, Ссылка, Аудио, Чат, Галерея, Статус
Scrollider Express В сторону, Изображение, Цитата, Видео, Ссылка
Sela В сторону, Галерея, Изображение, Цитата, Видео
Selecta В сторону, Аудио, Чат, Галерея, Изображение, Цитата, Видео
Последовательно В сторону, Изображение, Видео, Цитата, Ссылка, Статус
Полка Изображение, ссылка, цитата, видео, аудио
Shine On в сторону, аудио, чат, галерея, изображение, ссылка, цитата, статус, видео
Shrake в сторону, цитата, ссылка
Sidekick В сторону, Изображение, Видео, Цитата, Ссылка
Боковое видео В сторону, Изображение, Видео, Цитата, Ссылка, Галерея
Силезия В сторону, Изображение, Видео, Цитата, Ссылка
В сторону, Изображение, Видео, Цитата, Ссылка, Галерея
Скептически В сторону, Аудио, Чат, Галерея, Изображение, Ссылка, Цитата, Видео
Эскиз В сторону, Изображение, Видео, Цитата , Ссылка, Галерея, Аудио
Skylark Галерея, Изображение, Видео
Снимки В сторону, Аудио, Чат, Галерея, Изображение, Ссылка, Цитата, Статус, Видео
Sobe В сторону , Изображение, видео, Цитата, Ссылка, Аудио, Чат, Галерея, Статус
Solar В сторону, Аудио, Чат, Галерея, Изображение, Ссылка, Цитата, Статус, Видео
Something Fishy В сторону, Статус
Sorbet В сторону, Аудио, Изображение, Видео, Ссылка, Цитата, Галерея, Статус
Soundcheck Аудио, Галерея, Изображение, Видео
Spectrum В сторону, Изображение, Видео, Цитата, Ссылка, Галерея , Статус
Spirit В сторону, Изображение, Видео, Цитата, Ссылка, Статус
Вращение В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Статус
Стандартное Изображение, Ссылка , Цитата, Статус, Видео
Структура В сторону, Изображение, Видео, Цитата, Ссылка
Костюмы Аудио, В стороне, Чат, Галерея, Изображение, Ссылка, Цитата, Видео
Sundance
Супергерой В сторону, Изображение, Видео, Цитата, Ссылка
Sweet Life В сторону, Изображение, Видео, Цитата, Ссылка, Аудио, Чат, Галерея, Статус
Синтаксис В сторону, Изображение, Видео, Цитата, Ссылка, Галерея
Утро После В сторону
Гобелен В сторону, Аудио, Чат, Галерея, Изображение, Ссылка, Цитата, Статус, Видео
Tdeditor в сторону
в сторону парижан в сторону, изображение, видео, цитата, ссылка, аудио, галерея, статус
Titan в сторону, изображение, видео, цитата, ссылка
вместе вместе вместе , Изображение, Видео, Цитата, Ссылка, Аудио, Галерея, Статус
Панель инструментов В стороне, Галерея
Тональный В сторону, Аудио, Чат, Галерея, Изображение, Ссылка, Цитата, Статус, Видео
Toujours В сторону, Аудио, Галерея, Изображение, Ссылка, Цитата, Статус, Видео
Поистине Минимальный В сторону, Изображение, Видео, Цитата, Ссылка
Trvl В сторону, Аудио, Галерея , Изображение, ссылка, цитата, статус, видео
Tuned Balloon в сторону, галерея, ссылка, изображение, цитата, аудио
Twenty Eleven в сторону, изображение, видео, ссылка, цитата, галерея, статус
Twenty Fifteen В сторону, изображение, видео, цитата, ссылка, галерея, состояние, аудио, чат
Twenty Fourteen в сторону, аудио, галерея, изображение, ссылка, цитата, видео
Twenty Seventeen В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Аудио
Twenty Sixteen В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Статус, Аудио, Чат
Twenty Ten В сторону, изображение, Видео, цитата, ссылка, галерея
Twenty Twelve Aside, Image, Link, Quote
Twenty Thirteen Aside, Audio, Chat, Gallery, Image, Link, Quote, Status, Video
Опечатка В сторону, Изображение, Видео, Цитата, Ссылка, Аудио, Чат, Статус
Vagabond В сторону, Галерея, Изображение, Ссылка, Цитата, Видео
Veeva В сторону, Изображение, Видео, Цитата, ссылка, галерея
Venture Галерея, видео
Vertigo В стороне, аудио, чат, галерея, изображение, ссылка, цитата, статус, видео
Vintage Camera в сторону, изображение , Видео, цитата, ссылка, галерея, аудио, статус, чат
Vintage Kitchen Aside
Vision Image
Visual Aside, Image, Video, Quote, Link, Galler y
Широко В сторону, Изображение, Видео, Цитата, Ссылка, Галерея
Wilson В сторону, Изображение, Видео, Цитата, Ссылка
Writr В сторону, Изображение, Видео, Цитата, Ссылка, Галерея, Аудио, Статус, Чат
Wu Wei В сторону, Изображение, Видео, Цитата, Ссылка
Yoko В сторону, Галерея, Ссылка, Видео, Изображение, Цитата
Yumblog Видео, В стороне, Ссылка, Галерея, Статус, Цитата, Изображение
Zoren В сторону, Аудио, Галерея, Ссылка, Изображение, Цитата, Видео

Сообщение по электронной почте — Поддержка — WordPress. com

Публикация по электронной почте — это способ публикации сообщений в вашем блоге по электронной почте. Для отправки электронного письма можно использовать любой почтовый клиент, что позволяет быстро и легко публиковать сообщения с таких устройств, как сотовые телефоны. Обратите внимание, что вы можете публиковать сообщения только в одном блоге, используя одно сообщение электронной почты за раз.

Инструкции из этого руководства относятся к панели управления WP Admin. Вы можете перейти на эту панель управления, добавив / wp-admin в конец URL-адреса вашего сайта (например: example.wordpress.com/wp-admin)

Создание сообщения по адресу электронной почты

Перед публикацией по электронной почте необходимо создать специальный адрес электронной почты.Этот адрес уникален для вас и должен храниться в секрете (любой, кто знает адрес электронной почты, может опубликовать сообщение в вашем блоге).

  1. Сначала перейдите в панель управления -> Мои блоги .
  2. Убедитесь, что в настройках экрана включен параметр Отправка по электронной почте .
  3. Найдите блог, в котором вы хотите разместить сообщение, и нажмите Включить .
  4. Теперь у вас есть специальный адрес электронной почты, который вы можете использовать для отправки сообщений по электронной почте. Если вы хотите добавить адрес в свою адресную книгу, вы можете скачать его как vCard:

Примечание: Секретный адрес электронной почты предназначен для учетной записи пользователя, а не для блога.Если у вас многопользовательский блог, каждый из пользователей вашего блога может создавать свои собственные сообщения по адресу электронной почты, независимо от их роли.

Для пользователей с ролью «Участник» все отправленные по электронной почте сообщения будут сохраняться как ожидающие, а не опубликованные. Они получат подтверждение своего сообщения с содержанием сообщения в электронном письме, но не получат второе электронное письмо, когда их сообщение будет одобрено.

↑ Содержание ↑

Отправка электронных писем

Если у вас есть адрес для отправки по электронной почте, отправить электронное письмо очень просто:

Тема письма используется в качестве заголовка вашего сообщения.Тело — это содержание сообщения. Через несколько минут после получения электронного письма вы должны получить уведомление по электронной почте с подробностями опубликованного сообщения.

Примечание: Пожалуйста, не забудьте отправить письмо на на ваш секретный адрес , а не на пример, показанный на изображении выше.

↑ Содержание ↑

Форматирование почты

Ваша электронная почта может быть в виде обычного текста или в формате. Будет сохранено максимально возможное форматирование, хотя система Post by Email удалит ненужные HTML-теги, чтобы ваша электронная почта отображалась правильно.Обратите внимание, что вам нужно будет использовать почтовый клиент, который поддерживает форматированный текст или HTML-форматирование, чтобы использовать эту функцию. Большинство клиентов для веб-сайтов (Hotmail, Gmail) поддерживают это, как и большинство клиентов для настольных ПК (Outlook, Mail). Возможно, вам потребуется переключить ваш клиент в форматированный текст или форматированный режим.

↑ Содержание ↑

Приложения

Вложения изображений будут включены в ваше опубликованное сообщение следующим образом:

  • Одиночные изображения будут отображаться в строке (одиночное изображение определяется как изображение без изображения, непосредственно следующего за ним).
  • Несколько изображений будут отображаться в виде галереи.

В одном сообщении можно разместить несколько галерей и одно изображение. Обратите внимание, что использование шорткода [nogallery] отключит все галереи.

Если вы приобрели личный план WordPress.com или выше, то будут поддерживаться следующие дополнительные типы вложений:

  • Поддерживаемые аудиофайлы (mp3) будут отображаться с помощью аудиоплеера WordPress.
  • Все остальные файлы (doc, PDF и т. Д.) Будут отображаться в виде ссылок на вложение.

Кроме того, если вы приобрели план WordPress.com Premium или выше, вы сможете отправлять файлы mp4, mov, wmv, avi, mpg и m4v в качестве вложений, которые затем будут отображаться с помощью видео WordPress. игрок.

Обратите внимание, что вы можете отправлять свои вложения по адресу:

[email protected]

Ваши вложения будут храниться в вашей учетной записи без создания новой публикации — вложения появятся вместе с другими вашими медиафайлами.

↑ Содержание ↑

Шорткоды

Специальные шорткоды могут быть встроены в вашу электронную почту для настройки различных аспектов опубликованного сообщения:

  • [категория x, y, z]
  • [выдержка] некоторая выдержка [/ выдержка]
  • [теги x, y, z]
  • [задержка +1 час]
  • [комментировать | выкл]
  • [статус опубликован | ожидается | проект | частный]
  • [пароль секрет-пароль]
  • [slug some-url-name]
  • [title Заголовок сообщения]
  • [конец] — все, что находится после этого шорткода, игнорируется (т. е.е. подписи). Убедитесь, что он находится в отдельной строке с пустой строкой над ним.
  • [слайд-шоу] — заменяет автогалерею на слайд-шоу
  • [nogallery] — отключает автогалерею и отображает все изображения в строке
  • [подробнее] — дополнительный тег
  • [следующая страница] — пагинация
  • [геотег | off] — изменить настройки конфиденциальности по умолчанию для геотегов, чтобы включить или отключить отображение геоинформации.
  • [публикация отключена | twitter | facebook] — изменить параметры публикации (см. Ниже)
  • [опрос] вопросы и ответы [/ poll] — вставьте опрос Crowdsignal в свое сообщение (см. Ниже)

Короткие коды могут быть включены в любое место вашего электронного письма и должны быть в нижнем регистре.Между левой квадратной скобкой и содержимым шорткода не должно быть пробелов.

↑ Содержание ↑

Определение категории

Шорткод категории будет соответствовать началу заголовков категорий, а также идентификаторам категорий. Например:

[категория Hol, Fo]

Соответствует «Празднику» и «Еда». Обратите внимание, что категории уже должны существовать в вашем блоге, и пробелы между запятыми не важны.

↑ Содержание ↑

Определение тегов

В сообщение можно добавить любое количество тегов, разделенных запятыми:

[помечает один картофель, два картофеля, три картофеля и т. Д.]

Это добавит четыре тега: «один картофель», «два картофеля», «три картофеля» и «еще».Обратите внимание, что ваши теги не обязательно должны существовать в другом месте вашего блога, и новые теги будут созданы автоматически.

↑ Содержание ↑

Изменение настроек публикации

WordPress Publicize позволяет уведомлять другие веб-службы о ваших сообщениях. С помощью шорткода [опубликовать] вы можете управлять этим из электронной почты.

[публикация отключена] — отключить все уведомления о публикации

[publicize twitter] — отправлять уведомление только в Twitter

[publicize twitter] мой новый пост [/ publicize] — только отправить уведомление в Twitter и установить статус Twitter на мой новый пост

Обратите внимание, что ваши параметры публикации должны быть предварительно настроены.

↑ Содержание ↑

Вставка опроса Crowdsignal

Прежде чем использовать этот шорткод, вы должны сначала создать или импортировать учетную запись Crowdsignal в WordPress.com. После настройки вы можете вставить опрос в электронное письмо следующим образом:

[опрос]

Какой худший фильм десятилетия?

  • Гуру любви
  • Fool’s Gold

[/ poll]

Обратите внимание на то, как вопрос опроса добавляется после короткого кода [poll] , и каждый ответ находится в новой строке и начинается со звездочки.Опрос должен заканчиваться на [/ poll] .

Вы можете настроить свой опрос, добавив дополнительные сведения к шорткоду [poll] :

  • type = "single | multi | 2 | 3" — сколько раз голос может быть зарегистрирован ( single по умолчанию)
  • style = "manga medium" — стиль опроса, взятый со страницы опросов Crowdsignal.
  • other = "yes | no" — разрешить «другой» ответ ( нет по умолчанию)

Например, чтобы создать опрос в широком стиле «манга» и разрешить до трех ответов (включая ответ «другое»):

[poll other = "yes" type = "3"]

Какой худший фильм десятилетия?

  • Гуру любви
  • Fool’s Gold

[/ poll]

↑ Содержание ↑

Отложить публикацию

Шорткод задержки принимает любое время, разрешенное параметром strtotime PHP.Например, вы можете:

[задержка +1 час]

[задержка +2 дня]

Вы также можете запланировать публикацию сообщения в точное время, как в этом примере:

[задержка 2013-12-01 11:30:00 EST]

В приведенном выше шорткоде запланирована публикация сообщения 1 декабря 2013 г. в 11:30 по восточному поясному времени.

↑ Содержание ↑

Предоставление заголовка сообщения

Название вашего опубликованного сообщения обычно берется из темы вашего электронного письма. В некоторых случаях, например, при отправке электронного письма с некоторых сотовых телефонов или через шлюз MMS-электронной почты, вы не сможете указать тему. В этом случае вы можете установить заголовок своего сообщения прямо в письме:

[title My Fancy Post]

↑ Содержание ↑

Изменение статуса сообщения

Иногда вы можете захотеть, чтобы ваше сообщение было приватным или чтобы оно было рассмотрено вами или кем-то еще перед публикацией. Для этого вы можете использовать шорткод [status] , чтобы установить статус публикации.

[частный статус]

↑ Содержание ↑

Привязка геотегов

Если ваше электронное письмо включает изображение, которое содержит соответствующую информацию GPS (например, отправленное с iPhone), оно будет использоваться для геотегирования вашего сообщения. Информация будет доступна для публики, только если вы настроите свой блог для этого. Вы можете переопределить это для каждой электронной почты, используя короткие коды [geotag on] и [geotag off] .

Электронные письма, отправленные с устройства GPS SPOT, будут автоматически помечены геотегами.

↑ Содержание ↑

Подписи

При отправке по электронной почте автоматически удаляются все подписи электронной почты, соответствующие стандартному шаблону блока подписей:

–

(то есть тире )

Он также удалит все, что находится после HTML-тега

, и попытается очистить сигнатуры сети сотового телефона.

Если ваша система электронной почты прикрепляет подпись, которая не соответствует ни одному из этих шаблонов, вы можете вручную указать Post by Email прекратить включение текста, добавив специальный шорткод [конец] в отдельной строке с пустой строкой над ним.Все, что будет после этого, будет удалено из вашего сообщения. Если ваша сотовая сеть добавляет подпись, и вы хотите, чтобы мы ее удалили, сообщите нам подробности, и мы рассмотрим это.

↑ Содержание ↑

Пример электронного письма с короткими кодами

Следующее сообщение электронной почты будет опубликовано через два дня в категории «WordPress» с тегами «объявление» и «WordPress»:

Добро пожаловать в сообщение по электронной почте, самый простой способ вести блог!

[объявление тегов, WordPress]

[категория WordPress]

[задержка +2 дня]

Платформа идентификации Microsoft и протокол OpenID Connect — платформа идентификации Microsoft

  • 15 минут на чтение

В этой статье

OpenID Connect (OIDC) — это протокол аутентификации, основанный на OAuth 2.0, который можно использовать для безопасного входа пользователя в приложение. Когда вы используете реализацию OpenID Connect конечной точки платформы идентификации Microsoft, вы можете добавить в свои приложения вход и доступ через API. В этой статье показано, как это сделать независимо от языка, и описано, как отправлять и получать сообщения HTTP без использования каких-либо библиотек с открытым исходным кодом Microsoft.

OpenID Connect расширяет протокол авторизации OAuth 2.0 для использования в качестве протокола аутентификации , чтобы вы могли выполнять единый вход с использованием OAuth.OpenID Connect представляет концепцию маркера ID , который представляет собой маркер безопасности, который позволяет клиенту проверять личность пользователя. Маркер ID также получает основную информацию профиля о пользователе. Он также представляет конечную точку UserInfo, API, который возвращает информацию о пользователе.

Схема протокола: вход

Самый простой процесс входа состоит из шагов, показанных на следующей диаграмме. Каждый шаг подробно описан в этой статье.

OpenID Connect описывает документ метаданных (RFC), который содержит большую часть информации, необходимой приложению для входа в систему.Сюда входит такая информация, как используемые URL-адреса и расположение открытых ключей подписи службы. Вы можете найти этот документ, добавив путь к документу обнаружения к URL-адресу центра сертификации:

Путь к документу Discovery: /.well-known/openid-configuration

Авторитет: https://login.microsoftonline.com/{tenant}/v2.0

{tenant} может принимать одно из четырех значений:

Значение Описание
обычный Пользователи с личной учетной записью Microsoft и рабочей или учебной учетной записью из Azure AD могут войти в приложение.
организаций Только пользователи с рабочими или учебными учетными записями из Azure AD могут войти в приложение.
потребителей Только пользователи с личной учетной записью Microsoft могут войти в приложение.
8eaef023-2b34-4da1-9baa-8bc8c9d6a490 или contoso.onmicrosoft.com Только пользователи из определенного клиента Azure AD (независимо от того, являются ли они членами каталога с рабочей или учебной учетной записью или гостями в каталоге с личной учетной записью Microsoft) могут войти в приложение.Можно использовать либо понятное доменное имя клиента Azure AD, либо идентификатор GUID клиента. Вы также можете использовать арендатора-потребителя

40d-6c67-4c5b-b112-36a304b66dad вместо арендатора потребителей .

В разных национальных облаках полномочия различаются — например, https://login. microsoftonline.de для экземпляра Azure AD Germany. Если вы не используете общедоступное облако, просмотрите конечные точки национального облака, чтобы найти подходящую для вас.Убедитесь, что клиент и /v2.0/ присутствуют в вашем запросе, чтобы вы могли использовать версию v2.0 конечной точки.

Образец запроса

Чтобы вызвать конечную точку userinfo для общих полномочий в общедоступном облаке, используйте следующее:

  GET /common/v2.0/.well-known/openid-configuration
Хост: login.microsoftonline.com

Пример ответа

Метаданные — это простой документ JavaScript Object Notation (JSON). См. Пример в следующем фрагменте.Содержимое полностью описано в спецификации OpenID Connect.

  {
  "authorization_endpoint": "https://login.microsoftonline.com/{tenant}/oauth3/v2.0/authorize",
  "token_endpoint": "https://login.microsoftonline.com/{tenant}/oauth3/v2.0/token",
  "token_endpoint_auth_methods_supported": [
    "client_secret_post",
    "private_key_jwt"
  ],
  "jwks_uri": "https://login. microsoftonline.com/{tenant}/discovery/v2.0/keys",
  "userinfo_endpoint": "https://graph.microsoft.com/oidc/userinfo",
  "subject_types_supported": [
      "попарно"
  ],
  ...

}

Если ваше приложение имеет настраиваемые ключи подписи в результате использования функции сопоставления утверждений, вы должны добавить параметр запроса appid , содержащий идентификатор приложения, чтобы получить jwks_uri , указывающий на информацию о ключе подписи вашего приложения. Например: https://login.microsoftonline.com/{tenant}/v2.0/.well-known/openid-configuration?appid=6731de76-14a6-49ae-97bc-6eba6

1e содержит jwks_uri из https: //login.microsoftonline.com / {tenant} /discovery/v2.0/keys?appid=6731de76-14a6-49ae-97bc-6eba6

1e .

Обычно этот документ метаданных используется для настройки библиотеки OpenID Connect или SDK; библиотека будет использовать метаданные для выполнения своей работы. Однако, если вы не используете предварительно созданную библиотеку OpenID Connect, вы можете выполнить действия, описанные в оставшейся части этой статьи, чтобы выполнить вход в веб-приложение с помощью конечной точки платформы идентификации Microsoft.

Отправить запрос на вход

Когда вашему веб-приложению требуется аутентифицировать пользователя, оно может направить пользователя на конечную точку / авторизовать .Этот запрос похож на первую часть потока кода авторизации OAuth 2.0, но имеет следующие важные отличия:

  • Запрос должен включать область действия openid в параметр области области .
  • Параметр response_type должен включать id_token .
  • Запрос должен включать параметр nonce .

Важно

Чтобы успешно запросить маркер идентификатора из конечной точки / authorization, для регистрации приложения на портале регистрации необходимо включить неявное предоставление id_tokens на вкладке Authentication (которая устанавливает для флага oauth3AllowIdTokenImplicitFlow в манифесте приложения значение true ).Если он не включен, будет возвращена ошибка unsupported_response : «Указанное значение для входного параметра ‘response_type’ не разрешено для этого клиента. Ожидаемое значение — ‘code’»

Например:

  // Разрывы строк предназначены только для удобства чтения.

ПОЛУЧИТЬ https://login.microsoftonline.com/{tenant}/oauth3/v2.0/authorize?
client_id = 6731de76-14a6-49ae-97bc-6eba61e
& response_type = id_token
& redirect_uri = http% 3A% 2F% 2Flocalhost% 2Fmyapp% 2F
& response_mode = form_post
& scope = openid
& state = 12345
& nonce = 678910
Параметр Состояние Описание
арендатор Требуется Вы можете использовать значение {tenant} в пути запроса, чтобы контролировать, кто может входить в приложение.Допустимые значения: обычных , организаций , потребителей и идентификаторов арендаторов. Для получения дополнительной информации см. Основы протокола.
client_id Требуется Приложение (клиент) с идентификатором , который портал Azure — опыт регистрации приложений назначен вашему приложению.
response_type Требуется Должен включать id_token для входа в OpenID Connect.Он также может включать другие значения response_type , например code .
redirect_uri Рекомендуется URI перенаправления вашего приложения, по которому ваше приложение может отправлять и получать ответы на аутентификацию. Он должен точно соответствовать одному из URI перенаправления, который вы зарегистрировали на портале, за исключением того, что он должен быть закодирован в URL. Если его нет, конечная точка случайным образом выберет один зарегистрированный redirect_uri, чтобы отправить пользователя обратно.
объем Требуется Список областей, разделенных пробелами. Для OpenID Connect он должен включать область openid , которая переводится в разрешение «Войти» в пользовательском интерфейсе согласия. Вы также можете указать другие области в этом запросе для запроса согласия.
nonce Требуется Значение, включенное в запрос, созданный приложением, который будет включен в результирующее значение id_token в качестве утверждения.Приложение может проверить это значение, чтобы уменьшить атаки с воспроизведением токена. Значение обычно представляет собой случайную уникальную строку, которая может использоваться для определения источника запроса.
response_mode Рекомендуется Задает метод, который следует использовать для отправки результирующего кода авторизации обратно в ваше приложение. Может быть form_post или фрагмент . Для веб-приложений мы рекомендуем использовать response_mode = form_post , чтобы обеспечить наиболее безопасную передачу токенов в ваше приложение.
состояние Рекомендуется Значение, включенное в запрос, которое также будет возвращено в ответе токена. Это может быть строка с любым содержимым. Случайно созданное уникальное значение обычно используется для предотвращения атак с подделкой межсайтовых запросов. Состояние также используется для кодирования информации о состоянии пользователя в приложении до запроса аутентификации, например о странице или просмотре, на которых находился пользователь.
подсказка Дополнительно Указывает тип необходимого взаимодействия с пользователем.Единственные допустимые значения на данный момент: логин , нет и согласие . Утверждение prompt = login заставляет пользователя вводить свои учетные данные по этому запросу, что исключает возможность единого входа. Запрос = нет претензия — обратное. Это утверждение гарантирует, что пользователю не будет отображаться интерактивная подсказка на. Если запрос не может быть выполнен в автоматическом режиме с помощью единой регистрации, конечная точка платформы идентификации Майкрософт возвращает ошибку. Запрос = согласие запускает диалоговое окно согласия OAuth после входа пользователя в систему.В диалоговом окне пользователю предлагается предоставить разрешения приложению.
login_hint Дополнительно Вы можете использовать этот параметр для предварительного заполнения поля имени пользователя и адреса электронной почты на странице входа для пользователя, если вы заранее знаете имя пользователя. Часто приложения используют этот параметр во время повторной аутентификации после извлечения имени пользователя из предыдущего входа в систему с использованием утверждения предпочтительное_имя_пользователя .
domain_hint Дополнительно Область пользователя в объединенном каталоге.Это пропускает процесс обнаружения на основе электронной почты, который пользователь проходит на странице входа в систему, что упрощает взаимодействие с пользователем. Для клиентов, которые объединены через локальный каталог, например AD FS, это часто приводит к беспрепятственному входу из-за существующего сеанса входа в систему.

На этом этапе пользователю предлагается ввести свои учетные данные и завершить аутентификацию. Конечная точка платформы идентификации Microsoft проверяет, согласился ли пользователь с разрешениями, указанными в параметре запроса scope .Если пользователь не дал согласия на какие-либо из этих разрешений, конечная точка платформы идентификации Microsoft предлагает пользователю дать согласие на требуемые разрешения. Вы можете узнать больше о разрешениях, согласии и мультитенантных приложениях.

После аутентификации пользователя и предоставления согласия конечная точка платформы идентификации Microsoft возвращает ответ вашему приложению по указанному URI перенаправления с использованием метода, указанного в параметре response_mode .

Успешный ответ

Успешный ответ при использовании response_mode = form_post выглядит так:

  POST / myapp / HTTP / 1.1
Хост: localhost
Тип содержимого: application / x-www-form-urlencoded

id_token = eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1dCI6Ik1uQ19WWmNB . .. & state = 12345
Параметр Описание
id_token Маркер идентификатора, запрошенный приложением. Вы можете использовать параметр id_token , чтобы проверить личность пользователя и начать сеанс с пользователем. Дополнительные сведения о токенах ID и их содержимом см. В справочнике id_tokens .
состояние Если в запрос включен параметр состояния , то такое же значение должно появиться в ответе. Приложение должно проверять идентичность значений состояния в запросе и ответе.

Ответ об ошибке

Ответы об ошибках также могут быть отправлены на URI перенаправления, чтобы приложение могло их обработать. Ответ об ошибке выглядит так:

  POST / myapp / HTTP / 1.1
Хост: localhost
Тип содержимого: application / x-www-form-urlencoded

error = access_denied & error_description = + пользователь + отменен + аутентификация +
Параметр Описание
ошибка Строка кода ошибки, которую можно использовать для классификации типов возникающих ошибок и реагирования на ошибки.
error_description Специальное сообщение об ошибке, которое может помочь вам определить основную причину ошибки аутентификации.

Коды ошибок для ошибок конечной точки авторизации

В следующей таблице описаны коды ошибок, которые могут быть возвращены в параметре error ответа об ошибке:

Код ошибки Описание Действие клиента
invalid_request Ошибка протокола, например, отсутствует обязательный параметр. Исправьте ошибку и повторно отправьте запрос. Это ошибка разработки, которая обычно обнаруживается во время первоначального тестирования.
unauthorized_client Клиентское приложение не может запросить код авторизации. Обычно это происходит, когда клиентское приложение не зарегистрировано в Azure AD или не добавлено в клиент Azure AD пользователя. Приложение может предлагать пользователю инструкции по установке и добавлению его в Azure AD.
access_denied Владелец ресурса отказал в согласии. Клиентское приложение может уведомить пользователя о том, что оно не может продолжить работу без согласия пользователя.
unsupported_response_type Сервер авторизации не поддерживает тип ответа в запросе. Исправьте ошибку и повторно отправьте запрос. Это ошибка разработки, которая обычно обнаруживается во время первоначального тестирования.
server_error Сервер обнаружил непредвиденную ошибку. Повторите запрос.Эти ошибки могут возникать в результате временных условий. Клиентское приложение может объяснить пользователю, что его ответ задерживается из-за временной ошибки.
временно_не доступен Сервер временно слишком занят для обработки запроса. Повторите запрос. Клиентское приложение может объяснить пользователю, что его ответ задерживается из-за временного состояния.
invalid_resource Целевой ресурс недействителен, поскольку либо он не существует, либо Azure AD не может его найти, либо он неправильно настроен. Это означает, что ресурс, если он существует, не был настроен в клиенте. Приложение может предлагать пользователю инструкции по установке и добавлению его в Azure AD.

Проверить идентификационный токен

Просто получить id_token не всегда достаточно для аутентификации пользователя; вам также может потребоваться проверить подпись id_token и проверить утверждения в токене в соответствии с требованиями вашего приложения. Как и все платформы OIDC, конечная точка платформы идентификации Microsoft использует веб-токены JSON (JWT) и шифрование с открытым ключом для подписи токенов идентификатора и проверки их действительности.

Не все приложения получают выгоду от проверки токена ID — например, нативные приложения и одностраничные приложения редко получают выгоду от проверки токена ID. Кто-то, имеющий физический доступ к устройству (или браузеру), может обойти проверку разными способами — от редактирования веб-трафика до устройства для предоставления поддельных токенов и ключей до простой отладки приложения, чтобы пропустить логику проверки. С другой стороны, веб-приложения и API-интерфейсы, использующие токен идентификатора для авторизации, должны тщательно проверять этот токен, поскольку они закрывают доступ к данным.

После того, как вы проверили подпись id_token, вам потребуется проверить несколько утверждений. См. Справку id_token для получения дополнительной информации, в том числе о проверке токенов и важной информации о смене ключа подписи. Мы рекомендуем использовать библиотеку для анализа и проверки токенов — по крайней мере, одна доступна для большинства языков и платформ.

Вы также можете проверить дополнительные претензии в зависимости от вашего сценария. Вот некоторые общие проверки:

  • Проверка того, что пользователь / организация зарегистрировались в приложении.
  • Обеспечение пользователя надлежащей авторизацией / привилегиями
  • Обеспечение определенной силы аутентификации, например многофакторной аутентификации.

После проверки id_token вы можете начать сеанс с пользователем и использовать утверждения в id_token для получения информации о пользователе в вашем приложении. Эта информация может использоваться для отображения, записи, персонализации и т. Д.

Схема протокола: получение токена доступа

Многим веб-приложениям необходимо не только выполнить вход пользователя, но и получить доступ к веб-службе от имени пользователя с помощью OAuth.Этот сценарий сочетает OpenID Connect для аутентификации пользователя с одновременным получением кода авторизации, который вы можете использовать для получения токенов доступа, если вы используете поток кода авторизации OAuth.

Полный процесс входа в систему OpenID Connect и получения токена похож на следующую схему. Мы подробно опишем каждый шаг в следующих разделах статьи.

Получить токен доступа для вызова UserInfo

Чтобы получить токен для конечной точки OIDC UserInfo, измените запрос на вход:

  // Разрывы строк предназначены только для удобства чтения.ПОЛУЧИТЬ https://login.microsoftonline.com/{tenant}/oauth3/v2.0/authorize?
client_id = 6731de76-14a6-49ae-97bc-6eba61e // Ваш зарегистрированный идентификатор приложения
& response_type = id_token% 20token // это вернет и id_token, и токен доступа
& redirect_uri = http% 3A% 2F% 2Flocalhost% 2Fmyapp% 2F // Ваш зарегистрированный URI перенаправления, URL-адрес закодирован
& response_mode = form_post // 'form_post' или 'фрагмент'
& scope = openid + profile + email // Требуется `openid`.`profile` и` email` предоставляют дополнительную информацию в конечной точке UserInfo так же, как и в токене идентификатора. 
& state = 12345 // Любое значение, предоставленное вашим приложением
& nonce = 678910 // Любое значение, предоставленное вашим приложением

Вы также можете использовать поток кода авторизации, поток кода устройства или токен обновления вместо response_type = token , чтобы получить токен для своего приложения.

Подсказка

Щелкните следующую ссылку, чтобы выполнить этот запрос.После входа в систему ваш браузер будет перенаправлен на https: // localhost / myapp / с токеном идентификатора и токеном в адресной строке. Обратите внимание, что этот запрос использует response_mode = fragment только в демонстрационных целях — для веб-приложения мы рекомендуем использовать form_post для дополнительной безопасности, где это возможно.
https: //login.microsoftonline.com/common/oauth3/v2.0/authorize …

Успешный ответ токена

Успешный ответ от использования response_mode = form_post выглядит так:

  POST / myapp / HTTP / 1. 1
Хост: localhost
Тип содержимого: application / x-www-form-urlencoded
 access_token = eyJ0eXAiOiJKV1QiLCJub25jZSI6I ....
 & token_type = предъявитель
 & expires_in = 3598
 & scope = электронная почта + openid + профиль
 & id_token = eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI ....
 & state = 12345

Параметры ответа означают одно и то же, независимо от потока, используемого для их получения.

Параметр Описание
access_token Маркер, который будет использоваться для вызова конечной точки UserInfo.
token_type Всегда «Несущий»
expires_in Время в секундах до истечения срока действия токена доступа.
объем Разрешения, предоставленные токену доступа. Обратите внимание: поскольку конечная точка UserInfo размещена на MS Graph, здесь могут быть дополнительные области Graph, перечисленные здесь (например, user. read), если они были ранее предоставлены приложению. Это потому, что токен для данного ресурса всегда включает в себя все разрешения, предоставленные клиенту в данный момент.
id_token Маркер идентификатора, запрошенный приложением. Вы можете использовать токен идентификатора, чтобы проверить личность пользователя и начать сеанс с пользователем. Более подробную информацию о токенах ID и их содержимом вы найдете в справочнике id_tokens .
состояние Если в запрос включен параметр состояния, то же значение должно появиться в ответе. Приложение должно проверять идентичность значений состояния в запросе и ответе.

Ответ об ошибке

Ответы об ошибках также могут быть отправлены на URI перенаправления, чтобы приложение могло обработать их соответствующим образом. Ответ об ошибке выглядит так:

  POST / myapp / HTTP / 1.1
Хост: localhost
Тип содержимого: application / x-www-form-urlencoded

error = access_denied & error_description = + пользователь + отменен + аутентификация +
Параметр Описание
ошибка Строка кода ошибки, которую можно использовать для классификации типов возникающих ошибок и реагирования на ошибки.
error_description Специальное сообщение об ошибке, которое может помочь вам определить основную причину ошибки аутентификации.

Описание возможных кодов ошибок и рекомендуемых ответов клиентов см. В разделе Коды ошибок для ошибок конечной точки авторизации.

Если у вас есть код авторизации и токен идентификатора, вы можете войти в систему и получить токены доступа от его имени. Чтобы войти в систему, вы должны подтвердить токен идентификатора в точности, как описано.Чтобы получить токены доступа, выполните действия, описанные в документации по потоку кода OAuth.

Вызов конечной точки UserInfo

Просмотрите документацию UserInfo, чтобы узнать, как вызвать конечную точку UserInfo с этим токеном.

Отправить запрос на выход

Если вы хотите выйти из приложения для пользователя, недостаточно очистить файлы cookie вашего приложения или иным образом завершить сеанс пользователя. Вы также должны перенаправить пользователя на конечную точку платформы Microsoft Identity для выхода.Если вы этого не сделаете, пользователь повторно аутентифицируется в вашем приложении без повторного ввода своих учетных данных, потому что у него будет действительный сеанс единого входа с конечной точкой платформы идентификации Microsoft.

Вы можете перенаправить пользователя на точку end_session_endpoint , указанную в документе метаданных OpenID Connect:

  ПОЛУЧИТЬ https://login.microsoftonline.com/common/oauth3/v2.0/logout?
post_logout_redirect_uri = http% 3A% 2F% 2Flocalhost% 2Fmyapp% 2F
Параметр Состояние Описание
post_logout_redirect_uri Рекомендуется URL-адрес, на который перенаправляется пользователь после успешного выхода.Если параметр не указан, пользователю будет показано общее сообщение, созданное конечной точкой платформы идентификации Microsoft. Этот URL-адрес должен соответствовать одному из URI перенаправления, зарегистрированных для вашего приложения на портале регистрации приложений.

Единый выход

Когда вы перенаправляете пользователя на end_session_endpoint , конечная точка платформы идентификации Microsoft очищает сеанс пользователя в браузере. Однако пользователь может по-прежнему входить в другие приложения, использующие учетные записи Microsoft для аутентификации.Чтобы эти приложения могли одновременно вывести пользователя из системы, конечная точка платформы идентификации Microsoft отправляет HTTP-запрос GET на зарегистрированный LogoutUrl всех приложений, в которых пользователь в настоящее время вошел в систему. Приложения должны отвечать на этот запрос, очищая любой сеанс, который идентифицирует пользователя, и возвращая ответ 200 . Если вы хотите поддерживать единый выход в своем приложении, вы должны реализовать такой LogoutUrl в коде вашего приложения. Вы можете установить LogoutUrl на портале регистрации приложений.

Следующие шаги

HTTP-методы — Учебник по REST API

REST API позволяют разрабатывать любые веб-приложения со всеми возможными операциями CRUD (создание, получение, обновление, удаление). Руководящие принципы REST предлагают использовать определенный HTTP-метод для определенного типа обращения к серверу (хотя технически это правило можно нарушить, но это крайне не рекомендуется).

Используйте приведенную ниже информацию, чтобы найти подходящий HTTP-метод для действия, выполняемого API.

 Содержание

HTTP GET
HTTP POST
HTTP PUT
HTTP УДАЛИТЬ
HTTP-ПАТЧ
Резюме
Глоссарий

HTTP GET

Используйте запросы GET для получения только представления ресурса / информации — и не изменять его каким-либо образом. Поскольку запросы GET не изменяют состояние ресурса, это безопасные методы . Кроме того, API GET должны быть idempotent , что означает, что выполнение нескольких идентичных запросов должно приводить к одному и тому же результату каждый раз, пока другой API (POST или PUT) не изменит состояние ресурса на сервере.

Если Request-URI относится к процессу создания данных, то в качестве объекта в ответе должны быть возвращены произведенные данные, а не исходный текст процесса, если только этот текст не является выходом процесса. .

Для любого заданного HTTP GET API, если ресурс найден на сервере, он должен вернуть код ответа HTTP 200 (OK) — вместе с телом ответа, которое обычно является содержимым XML или JSON (из-за их платформенно-независимый характер).

Если ресурс НЕ найден на сервере, он должен вернуть код ответа HTTP 404 (НЕ НАЙДЕН) . Точно так же, если определено, что сам запрос GET сформирован неправильно, сервер вернет код ответа HTTP 400 (ПЛОХОЙ ЗАПРОС) .

Пример URI запроса
  • HTTP GET http://www.appdomain.com/users
  • HTTP GET http://www.appdomain.com/users?size=20&page=5
  • HTTP GET http: // www.appdomain.com/users/123
  • HTTP GET http: // www.appdomain.com/users/123/address

HTTP POST

Используйте POST API для создания новых подчиненных ресурсов , например, файл подчинен каталогу, содержащему его, или строка подчиняется таблице базы данных. Если говорить строго в терминах REST, методы POST используются для создания нового ресурса в коллекции ресурсов.

В идеале, если ресурс был создан на исходном сервере, ответ ДОЛЖЕН иметь код ответа HTTP 201 (Создано) и содержать объект, который описывает статус запроса

Пути и операции

OAS 3 Эта страница относится к OpenAPI 3 — последней версии спецификации OpenAPI.Если вы используете OpenAPI 2 (fka Swagger), посетите страницы OpenAPI 2.

Пути и операции

В терминах OpenAPI пути — это конечные точки (ресурсы), такие как / users или / reports / summary / , которые предоставляет ваш API, а операции — это HTTP-методы, используемые для управления этими путями, например GET, POST или DELETE.

Пути

Пути и операции

API определены в глобальном разделе путей спецификации API.

  путей:
/пинг:
. ..
/ пользователи:
...
/ users / {id}:
...

Все пути указаны относительно URL-адреса сервера API. Полный URL-адрес запроса составляет / path . Глобальные серверы также можно переопределить на уровне пути или на уровне операции (подробнее об этом ниже). Пути могут иметь необязательное краткое описание и более длинное описание для целей документации.Эта информация должна относиться ко всем операциям на этом пути. описание может быть многострочным и поддерживает Markdown (CommonMark) для форматированного текстового представления.

  путей:
/ users / {id}:
сводка: представляет пользователя
описание:>
Этот ресурс представляет отдельного пользователя в системе.
Каждый пользователь идентифицируется числовым идентификатором.

получить:
...
патч:
...
удалять:
...

Шаблон пути

Вы можете использовать фигурные скобки {} , чтобы пометить части URL как параметры пути:

  / пользователей / {id}
/ организации / {orgId} / members / {memberId}
/report.{format}

Клиент API должен предоставить соответствующие значения параметров при вызове API, например / users / 5 или / users / 12 .

Операции

Для каждого пути вы определяете операции (методы HTTP), которые можно использовать для доступа к этому пути.OpenAPI 3.0 поддерживает get , post , put , patch , delete , head , options и trace . Один путь может поддерживать несколько операций, например GET / users для получения списка пользователей и POST / users для добавления нового пользователя. OpenAPI определяет уникальную операцию как комбинацию пути и метода HTTP. Это означает, что два метода GET или два метода POST для одного и того же пути недопустимы — даже если они имеют разные параметры (параметры не влияют на уникальность).Ниже приведен минимальный пример операции:

  путей:
/пинг:
получить:
ответы:
'200':
описание: ОК

Вот более подробный пример с параметрами и схемой ответа:

  путей:
/ users / {id}:
получить:
теги:
- Пользователи
Сводка: получает пользователя по идентификатору.
описание:>
Подробное описание операции.
Используйте уценку для форматированного текстового представления,
например ** жирный **, * курсив * и [ссылки] (https: // swagger.io).
operationId: getUserById
параметры:
- имя: id
в: путь
описание: ID пользователя
требуется: true
схема:
тип: целое число
формат: int64
ответы:
'200':
описание: Успешная операция
содержание:
приложение / json:
схема:
$ ref: '# / components / schemas / User'
externalDocs:
description: узнайте больше о пользовательских операциях, предоставляемых этим API.URL: http://api.example.com/docs/user-operations/

составные части:
схемы:
Пользователь:
тип: объект
свойства:
мне бы:
тип: целое число
формат: int64
название:
тип: строка
требуется:
- мне бы
- наименование

Операции также поддерживают некоторые дополнительные элементы для целей документации:

  • Краткое сводное и более длинное описание того, что делает операция. описание может быть многострочным и поддерживает Markdown (CommonMark) для форматированного текстового представления.
  • теги — используются для логической группировки операций по ресурсам или любому другому определителю. См. Группирование операций с помощью тегов.
  • externalDocs — используется для ссылки на внешний ресурс, содержащий дополнительную документацию.

Параметры работы

OpenAPI 3.0 поддерживает параметры операции, передаваемые через путь, строку запроса, заголовки и файлы cookie.Вы также можете определить тело запроса для операций, передающих данные на сервер, таких как POST, PUT и PATCH. Дополнительные сведения см. В разделах «Описание параметров и тела запроса».

Строка запроса в путях

Параметры строки запроса нельзя включать в пути . Вместо этого они должны быть определены как параметры запроса.

Неправильно:

  путей:
/ users? role = {role}:

Правильно:

  путей:
/ пользователи:
получить:
параметры:
- в: запрос
имя: роль
схема:
тип: строка
enum: [пользователь, poweruser, admin]
требуется: true

Это также означает, что невозможно иметь несколько путей, которые отличаются только строкой запроса, например:

  GET / пользователи? FirstName = value & lastName = value
GET / users? Role = значение

Это связано с тем, что OpenAPI рассматривает уникальную операцию как комбинацию пути и метода HTTP, а дополнительные параметры не делают операцию уникальной.Вместо этого вы должны использовать уникальные пути, например:

  GET / users / findByName? FirstName = value & lastName = value
GET / users / findByRole? Role = значение

operationId

operationId — необязательная уникальная строка, используемая для идентификации операции. Если предоставлено, эти идентификаторы должны быть уникальными среди всех операций, описанных в вашем API.

  / пользователей:
получить:
operationId: getUsers
сводка: получает всех пользователей
...
Почта:
operationId: addUser
резюме: добавляет нового пользователя
...
/ID пользователя}:
получить:
operationId: getUserById
сводка: получает пользователя по идентификатору пользователя
...

Некоторые распространенные варианты использования operationId:

  • Некоторые генераторы кода используют это значение для именования соответствующих методов в коде.
  • Ссылки могут ссылаться на связанные операции по operationId .

Устаревшие операции

Вы можете пометить определенные операции как устаревшие , чтобы указать, что они должны быть выведены из использования:

  / pet / findByTags:
получить:
устарело: true

Инструменты могут обрабатывать устаревшие операции определенным образом.Например, пользовательский интерфейс Swagger отображает их в другом стиле:

Переопределение глобальных серверов

Глобальный массив серверов может быть переопределен на уровне пути или уровне операции. Это полезно, если некоторые конечные точки используют другой сервер или базовый путь, чем остальная часть API. Общие примеры:

  • Другой базовый URL для операций загрузки и выгрузки файлов.
  • Устаревшие, но все еще работающие конечные точки.
  серверов:
- URL: https: // api.example.com/v1

пути:
/ файлы:
описание: операции загрузки и скачивания файлов
серверы:
- url: https://files.example.com
описание: Заменить базовый путь для всех операций с путем / files
...

/пинг:
получить:
серверы:
- url: https://echo.example.com
описание: Заменить базовый путь для операции GET / ping

Не нашли то, что искали? Задайте вопрос сообществу
Нашли ошибку? Сообщите нам

Услуги для отправителей и провайдеров

Услуги для отправителей и провайдеров

Решения для отправителей

Злоупотребления электронной почтой, нежелательная почта и мошеннические электронные письма (фишинг) продолжают обременять всю экосистему электронной почты.Чтобы помочь восстановить доверие потребителей к использованию электронной почты, Microsoft внедрила различные политики и технологии, которые помогают защитить наших потребителей. Однако Microsoft понимает, что это не должно отрицательно сказаться на законных отправителях электронной почты. Поэтому мы создали набор служб, чтобы помочь отправителям улучшить их доставку для потребителей Outlook.com за счет упреждающего управления репутацией отправителей.

Ниже приведен обзор услуг, которые могут принести пользу вашей организации, включая ссылки для получения дополнительной информации:

Сервис

Льготы

Postmaster
  • Отправная точка для любых вопросов, связанных с доставкой сообщений в Outlook.com пользователи
  • Включает простое онлайн-руководство с нашими политиками и требованиями
  • Обзор фильтров нежелательной почты и технологий аутентификации, используемых Microsoft
Сертификация обратного тракта
Программа отчетов о нежелательной почте
  • Бесплатная служба для предоставления отчетов о проблемах нежелательной почты, о которых сообщает Outlook.com пользователи
  • Возвращает полное сообщение с заголовками любого электронного письма, помеченного как «нежелательное» или «фишинговое».
  • Предоставляет отправителям возможность очищать свои списки адресов электронной почты и улучшать качество их содержания.
  • Помогает выявить потенциальные проблемы с вашей маркетинговой практикой и контентом
  • Помогает улучшить репутацию отправителя за счет удаления нежелательных подписчиков из списков
  • Зарегистрируйтесь на https: // postmaster.live.com/snds/JMRP.aspx и обычно начинают получать отзывы в течение 72 часов.
Smart Network Data Services
  • Бесплатная служба, которая предоставляет подробные сведения о том, как пользователи оценивают получаемое электронное письмо, и состояние вашего IP-пространства с точки зрения системы Outlook.com
  • Обеспечивает легкую онлайн-регистрацию и доступ к данным
  • Улучшает понимание того, как наши фильтры оценивают вашу электронную почту
  • Показывает, сколько пользователей жаловались на ваш адрес электронной почты
  • Узнайте больше на https: // postmaster.live.com/snds
Поддержка
  • Предоставляет поддержку при эскалации проблем с доставкой. Информацию о поддержке можно найти на странице устранения неполадок.

Решения ISP

Microsoft понимает, что ни одна организация не может изменить или устранить злоупотребления электронной почтой в одиночку.Провайдеры интернет-услуг (ISP) играют важную роль в выявлении и пресечении злоупотреблений, поскольку у них есть миллионы учетных записей электронной почты по всему миру. Поэтому мы создали несколько сервисов, чтобы помочь интернет-провайдерам получить хорошее представление о типах трафика, исходящего из их сетей и доходящего до клиентов Outlook.com. Затем интернет-провайдеры могут использовать эти данные, чтобы помочь остановить злонамеренные действия (нежелательная электронная почта, фишинг и т. Д.) В своих сетях, чтобы снизить общие затраты и проактивно управлять своей репутацией.

Ниже приведен обзор услуг, которые могут принести пользу вашей организации, включая ссылки для получения дополнительной информации:

Сервис

Льготы

Postmaster
  • Отправная точка для любых вопросов, связанных с доставкой сообщений в Outlook.com пользователи
  • Включает простое онлайн-руководство с нашими политиками и требованиями
  • Обзор фильтров нежелательной почты и технологий аутентификации, используемых Microsoft
Программа отчетов о нежелательной почте
  • Бесплатная служба для предоставления отчетов о проблемах нежелательной почты, о которых сообщили пользователи Outlook.com
  • Возвращает полное сообщение с заголовками любого электронного письма, помеченного как «нежелательное» или «фишинговое».
  • Помогает идентифицировать учетные записи клиентов или компьютеры, которые используются для отправки нежелательной электронной почты
  • Зарегистрируйтесь на https: // postmaster.live.com/snds/JMRP.aspx и обычно начинают получать отзывы в течение 72 часов.
Smart Network Data Services
  • Бесплатная служба, которая предоставляет подробные сведения о том, как пользователи оценивают получаемое электронное письмо, и состояние вашего IP-пространства с точки зрения системы Outlook.com
  • Обеспечивает легкую онлайн-регистрацию и доступ к данным
  • Интернет-провайдеры могут добиться экономии за счет борьбы со спамерами с помощью своей сети
  • Интернет-провайдеры могут повысить уровень удовлетворенности клиентов за счет повышения доставляемости
  • Узнайте больше на https: // postmaster.live.com/snds
Поддержка
  • Предоставляет поддержку при эскалации проблем с доставкой. Информацию о поддержке можно найти на странице устранения неполадок.

Сообщить о нежелательной почте, исходящей от Outlook.com

Иногда Outlook.com используется третьими сторонами для отправки нежелательной почты в нарушение наших условий использования и политики.Если вы получаете нежелательную почту от Outlook.com, вы можете сообщить об этих сообщениях по адресу [email protected]. Прикрепите оскорбительные сообщения в формате RFC2822 или ARF.

.

No related posts.

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *

*

*

*