Сваг

Examples

Descriptions over multiple lines

You can add descriptions spanning multiple lines in either the general api description or routes definitions like so:

// @description This is the first line
// @description This is the second line
// @description And so forth.

User defined structure with an array type

// @Success 200 {array} model.Account <-- This is a user defined struct.

package model

type Account struct {
    ID   int    `json:"id" example:"1"`
    Name string `json:"name" example:"account name"`
}

Model composition in response

// JSONResult's data field will be overridden by the specific type proto.Order
@success 200 {object} jsonresult.JSONResult{data=proto.Order} "desc"

type JSONResult struct {
    Code    int          `json:"code" `
    Message string       `json:"message"`
    Data    interface{}  `json:"data"`
}

type Order struct { //in `proto` package
    Id  uint            `json:"id"`
    Data  interface{}   `json:"data"`
}

also support array of objects and primitive types as nested response

@success 200 {object} jsonresult.JSONResult{data=[]proto.Order} "desc"
@success 200 {object} jsonresult.JSONResult{data=string} "desc"
@success 200 {object} jsonresult.JSONResult{data=[]string} "desc"

overriding multiple fields. field will be added if not exists

@success 200 {object} jsonresult.JSONResult{data1=string,data2=[]string,data3=proto.Order,data4=[]proto.Order} "desc"

overriding deep-level fields

type DeepObject struct { //in `proto` package
	...
}
@success 200 {object} jsonresult.JSONResult{data1=proto.Order{data=proto.DeepObject},data2=[]proto.Order{data=[]proto.DeepObject}} "desc"

Add a headers in response

// @Success 200 {string} string	"ok"
// @failure 400 {string} string	"error"
// @response default {string} string	"other error"
// @Header 200 {string} Location "/entity/1"
// @Header 200,400,default {string} Token "token"
// @Header all {string} Token2 "token2"

Use multiple path params

/// ...
// @Param group_id path int true "Group ID"
// @Param account_id path int true "Account ID"
// ...
// @Router /examples/groups/{group_id}/accounts/{account_id} 

Example value of struct

type Account struct {
    ID   int    `json:"id" example:"1"`
    Name string `json:"name" example:"account name"`
    PhotoUrls []string `json:"photo_urls" example:"http://test/image/1.jpg,http://test/image/2.jpg"`
}

Use swaggertype tag to supported custom type

type TimestampTime struct {
    time.Time
}

///implement encoding.JSON.Marshaler interface
func (t *TimestampTime) MarshalJSON() ([]byte, error) {
    bin := make([]byte, 16)
    bin = strconv.AppendInt(bin, t.Time.Unix(), 10)
    return bin, nil
}

func (t *TimestampTime) UnmarshalJSON(bin []byte) error {
    v, err := strconv.ParseInt(string(bin), 10, 64)
    if err != nil {
        return err
    }
    t.Time = time.Unix(v, )
    return nil
}
///

type Account struct {
    // Override primitive type by simply specifying it via `swaggertype` tag
    ID     sql.NullInt64 `json:"id" swaggertype:"integer"`

    // Override struct type to a primitive type 'integer' by specifying it via `swaggertype` tag
    RegisterTime TimestampTime `json:"register_time" swaggertype:"primitive,integer"`

    // Array types can be overridden using "array,<prim_type>" format
    Coeffs []big.Float `json:"coeffs" swaggertype:"array,number"`
}

type CerticateKeyPair struct {
	Crt []byte `json:"crt" swaggertype:"string" format:"base64" example:"U3dhZ2dlciByb2Nrcw=="`
	Key []byte `json:"key" swaggertype:"string" format:"base64" example:"U3dhZ2dlciByb2Nrcw=="`
}

generated swagger doc as follows:

"api.MyBinding": {
  "type":"object",
  "properties":{
    "crt":{
      "type":"string",
      "format":"base64",
      "example":"U3dhZ2dlciByb2Nrcw=="
    },
    "key":{
      "type":"string",
      "format":"base64",
      "example":"U3dhZ2dlciByb2Nrcw=="
    }
  }
}

Add extension info to struct field

type Account struct {
    ID   string    `json:"id"   extensions:"x-nullable,x-abc=def"` // extensions fields must start with "x-"
}

generate swagger doc as follows:

"Account": {
    "type": "object",
    "properties": {
        "id": {
            "type": "string",
            "x-nullable": true,
            "x-abc": "def"
        }
    }
}

How to using security annotations

General API info.

// @securityDefinitions.basic BasicAuth

// @securitydefinitions.oauth2.application OAuth2Application
// @tokenUrl https://example.com/oauth/token
// @scope.write Grants write access
// @scope.admin Grants read and write access to administrative information

Each API operation.

// @Security ApiKeyAuth

Make it AND condition

// @Security ApiKeyAuth
// @Security OAuth2Application

Виды: какие бывают?

Равносторонний сваг

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

Сваг используется для украшения оконного проема.

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

1. Середина;
2. Плечо;
3. Глубина;
4. Длина нижнего провиса.

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

Асимметричный сваг

У этого вида плечи будут разные: одно шире, а другое более узкое.

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

Опишем, как раскроить с рассчитать параметры свага. Для построения этого элемента можно выбрать ткань размером 140*140, далее делим этот отрезок мелом на две половины по диагонали. После чего в обе стороны нужно провести линии, которые будут равны половине длины элемента, делаем это перпендикулярно. На концах получившейся линии ставим точку №1 и точку №2.

Правильный подбор цвета и фактур поможет оживить помещение, оформленное в стиле Модерн и даже Хай-тек, привнеся свою долю авангарда.

Важно! Обязательно нужно учитывать припуски, чтобы потом обработать края (примерно 05, – 1 см). Под углом 15 градусов из точек 1 и 2 нужно отложить отрезки, которые по длине будут такими же, как плечо свага (если не доверяете своему глазомеру, используйте транспортир)

На концах отрезка нужно поставить точку №3 и точку №4

Под углом 15 градусов из точек 1 и 2 нужно отложить отрезки, которые по длине будут такими же, как плечо свага (если не доверяете своему глазомеру, используйте транспортир). На концах отрезка нужно поставить точку №3 и точку №4.

«Сваг» в переводе с английского означает «гирлянда» или «орнамент в виде листьев».

На самой диагонали нужно отменить глубину провиса (пусть она будет отмечена как точку А), дугой соединяем точки А и 3, а также точки А и 4. Выкройка готова.

Attribute

// @Param enumstring query string false "string enums" Enums(A, B, C)
// @Param enumint query int false "int enums" Enums(1, 2, 3)
// @Param enumnumber query number false "int enums" Enums(1.1, 1.2, 1.3)
// @Param string query string false "string valid" minlength(5) maxlength(10)
// @Param int query int false "int valid" minimum(1) maximum(10)
// @Param default query string false "string default" default(A)
// @Param collection query []string false "string collection" collectionFormat(multi)

It also works for the struct fields:

type Foo struct {
    Bar string `minLength:"4" maxLength:"16"`
    Baz int `minimum:"10" maximum:"20" default:"15"`
    Qux []string `enums:"foo,bar,baz"`
}

Available

Field Name	Type	Description
validate		Determines the validation for the parameter. Possible values are: .
default	*
maximum
minimum
maxLength
minLength
enums
format
collectionFormat		Determines the format of the array if type array is used. Possible values are: — comma separated values . — space separated values . — tab separated values . — pipe separated values . — corresponds to multiple parameter instances instead of multiple values for a single instance . This is valid only for parameters «query» or «formData». Default value is .

Употребление в Америке

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

Иногда swag означает глагол «качаться» — в смысле, на
тренажерах. Что ж, те молодые люди, которые считают себя в этом стиле,
действительно должны иметь мускулистое, спортивное тело. Желательно, чтобы
бицепсы и грудные мышцы были видны под одеждой и украшены пирсингом,
татуировками, толстыми цепями с крестами и кулонами.

Изготовление свагов

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

Статья по теме: Как и чем лучше клеить пластиковый уголок

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

Как крепить ламбрекен?

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

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

Теперь надо приступить к крепежу свага за его центральную часть, при этом он должен немного выступать над монтажной планкой на 5 см. После этого первая складка крепится слева и справа от середины конструкции. Так постепенно фиксируются все складки, последняя остается в прежнем состоянии.

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

Чтобы сделать ламбрекен, необходимо предварительно выбрать тип конструкции, подготовить все материалы. После этого составляется выкройка, раскраивается материал

Важно правильно укрепить уже готовую ткань на доске. Если этого не сделать, то складки не примут ту форму, которая необходима

Сваг

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

Традиционные сваги

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

На этой странице представлено видео и пошаговая инструкция, как сделать сваги своими руками.

Кроссовки в стиле Swag

Если вы решили обновиться свой гардероб и приобрести модную мужскую одежду и обувь в стиле swag, вам никак не обойтись без трендовых кроссовок. О всем известных Air Max’ах или Jordan’ах рассказывать смысла нет, поэтому мы обратимся к более интересным моделям, о которых знают единицы.

Культовый бренд Onitsuka Tiger, зарекомендовавший себя с 1949 года, создают как современных ультрамодные модели, так и обувь с намеком на винтаж. Еще одна вещь олдскул, которая должна быть в гардеробе каждого любителя swag, это New Balance. Дикая мода на них был еще в Советском союзе, а в преступные 90-е за такие кроссовки могли убить. Сейчас они не требуют таких жертв и доступны каждому.

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

Следует также отметить работу компании Adidas, которая всегда стремилась догнать Nike и разработать интересные модели. У нее это получилось! Совместная работа с Undefeated не оставила равнодушным не одного свэг-боя.Фантастическую обувь в стиле свэг вы можете также найти в коллекциях Fred Perry и Vans.

Основные тенденции при выборе стиля Swag

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

Что касается выбора цветовой гаммы, то в данном случае, она может быть как пастельных оттенков, так и «неприлично» ярких и кричащих

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

Одной из основ стиля является фраза: «Не останавливайся на брендах – создавай собственные!». Каждый свегер, вне зависимости от пола и возраста, несмотря на соблюдение всех правил и рекомендаций, не должен быть похож на своих «коллег по цеху». Создание Свэг – образа – это кропотливая работа для творческих личностей, которая потребует мобилизации всех способностей внутреннего дизайнера.

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

• Кепки в стиле рэперов;
• Шапки с необычными принтами и стильными надписями;
• Бейсболки;
• Венгерки.

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

Не стоит думать, что обувь должна быть подобрана особенным образом. Испытываете любовь к кедам – отличное решение! Не можете прожить и дня без каблуков – тоже неплохо. В любом случае будет приветствоваться обувь, которая будет украшена самыми разнообразными надписями и даже флагом США. Для создания рокового образа стоит внимательнее присмотреться к пайеткам и шипам.

Виды

Создавать сваги – очень тяжёлый и кропотливый труд, но есть и более простые варианты, например, «ракушка». Данный вид декора сможет создать даже начинающая мастерица. Из-за его внешнего сходства с ракушкой он и получил такое название.

Сваг имеет несколько элементов: левое и правое крыло, нижний и верхний провис.

Есть несколько видов свагов:

• симметричный;
• асимметричный;
• с вертикальным крылом;
• цельнокроенный;
• перекид (открытый сваг);
• на подкладке и без;
• двухуровневые.

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

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

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

У свагов с подкладкой нижний край обрабатывается швами различных видов. На верхнем крае необходимо заложить складки, для этого можно использовать и шторную ленту. Часто сваги сочетают с такими элементами, как галстуки и джаботы. Для создания двухуровневой композиции берут сваги разной длины и ширины, в которых могут отличаться размерами центральные и боковые элементы. Их подвешивают на различном расстоянии от карниза, создавая изысканные композиции.

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

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

Обувь в стиле SWAG

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

Что касается конкретных брендов, то наибольшей любовью у свеггеров традиционно пользуются кеды Nike. В фаворе также обувь Adidas и Puma. Впрочем, последний производитель почему-то в нашей стране не является лидером по популярности.

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

Что такое сваг?

Те, кто впервые столкнулись с процессом выбора новых штор, нередко задаются вопросом “Что же такое сваг?”. Сваг – это один из элементов, которым можно декорировать шторы, а именно дополнение к ламбрекену (его верхнюю часть), ее драпируют особым способом. Выглядит он как полукруг, на котором располагаются складки. Состоит он из головы и плечей (некоторые называют их крыльями).

Гардины могут выглядеть как настоящее произведение искусства, если для их создания будут использованы сваги.

Глубина – это степень его провиса, длина – это та длина, которую этот элемент занимает на карнизе. Далее идет средняя часть – середина по карнизу. Плечо – это часть с драпировкой складками и другими тканями. Еще при подготовке выкройки встречается понятие “провис” (втрое название – “глубина”), это та длина, на которую нижняя часть может опуститься от верхней. Обычно сложность бывает в том, чтобы правильно их уложить, но если все сделать верно, то они станут настоящей изюминкой в стиле вашей комнаты.

Если вы представите изысканные дорогие портьеры, то скорее всего, они будут украшены ламбрекеном со свагами.

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

Ассортимент

Ассор­ти­мент авто­зап­ча­стей SWAG

Про­из­во­ди­тель пред­ла­га­ет: эле­мен­ты ДВС, ходо­вой, жид­ко­сти, все­воз­мож­ные чех­лы, под­шип­ни­ки и колен­ча­тые валы, опо­ры и тяги, мас­ло­на­со­сы, баш­ма­ки, бол­ты, валы и мно­гое дру­гое. В целом, в ката­ло­ге изго­то­ви­те­ля – более 13 500 наиме­но­ва­ний продукции.

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

Так­же под мар­кой SWAG паку­ют­ся и реа­ли­зу­ют­ся зап­ча­сти дру­гих изго­то­ви­те­лей, кото­рые вхо­дят в Bilstein Group.

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

Това­ры про­из­во­ди­те­ля сер­ти­фи­ци­ро­ва­ны по стан­дар­ту ISO9001.

На дан­ный момент в товар­ные груп­пы SWAG вхо­дят: дета­ли ДВС, дета­ли авто­мо­биль­ной ходо­вой, тех­ни­че­ские жид­ко­сти, раз­лич­но­го рода защит­ные чех­лы, под­шип­ни­ки, тро­со­вое управ­ле­ние, весь спектр рези­но­ме­тал­ли­че­ских изде­лий, дета­ли тор­мо­за, эле­мен­ты авто­мо­биль­ной элек­три­ки и руле­во­го меха­низ­ма. Авто­лю­би­те­ли отме­ти­ли, что прак­ти­че­ски вся про­дук­ция под име­нем SWAG отли­ча­ет­ся сред­ним каче­ством. Рыча­ги, дат­чи­ки и все шаро­вые соеди­не­ния доволь­но каче­ствен­ные, но отнюдь не все­гда соот­вет­ству­ют сто­ко­вым реше­ни­ям. Дета­ли тор­мо­за и дви­га­те­ля име­ют весь­ма уме­рен­ные оцен­ки. Не отли­ча­ют­ся высо­ким каче­ством сайлентблоки.

Что такое SWAG и как переводится СВЭГ на русский язык?!

19.08.2016

Блог

Сегодня в молодёжной среде можно услышать много разных, непонятных обычному человеку, слов. Большинство из них — это сленговые слова, заимствованные, к тому же, в том или ином иностранном языке. Чаще из английского, реже из французского, немецкого и испанского.
Одно из ярких примеров такого явления — слово SWAG, которое очень популярно во многих странах мира. Произносится оно как «свэг» или «свег», несколько раз слышал вариант — «сваг». Какой из них более правильный? Сложно сказать. С точки зрения английской грамматики правильным должен являться первый. Но если учитывать, что корни этого слова уходят в американский рэп, то однозначно утверждать ничего нельзя! Давайте подробнее разберёмся что это значит и какой смысл носит!

Перевод и значение слова SWAG

Как я уже сказал выше, прародителем слова «Свэг» был американский уличный рэп. Если точнее — первоисточником его можно по праву считать популярную песню «Soulja Boy — Turn my swag on». Название сего творения на русский язык можно перевести как «Зацени мой стиль». Но однозначно сказать, что это означает «Стиль» нельзя. Дело в том, что на русский язык слово «Swag» в этом своём значении перевода не имеет. Нет, конечно, если Вы введёте его в переводчик Google, то получите целый ряд вариантов — халява, добыча, пожитки и т.п. Но ни один из них не будет верным. Тут правильнее сказать, что песня дала толчок к появлению нового термина, характеризующего определённое направление в одежде, музыке и поведении человека.

Если попытаться выделить краткое значение SWAG — то получится «крутость», «понты» или даже «Шик». Крутость в первую очередь в поведении, одежде и музыке, которую Вы слушаете

Например, если раньше у свеггеров был популярен Rap и R’n’B, то сейчас на первый план вышел Trap).
Приверженца направления Свэг можно охарактеризовать как «Выпендрёжник» или «Понтушник», то есть человек, который привлекает к себе внимание окружающих

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

Сейчас даже появились ряд брендов для парней и девушек, которые выпускают одежду придерживаясь общего стиля данного направления — Mishka NYC, Blvk Scvle, T-Shirt, New Era.

Эти бренды не дешевы, но с другой стороны если Вы считаете себя нереально крутым Swag Style Man, то финансовая часть вопроса не должна Вас волновать. Ведь Вы же показываете, что являетесь стильным, успешным и уверенным в себе человеком. Не даром же реперы обвешивают себя золотом и щеголяют на дорогих машинах! Да, Свег он такой!
Хотя на самом деле, дорогие шмотки и тачки это не главное. Главное за налётом шикарности не забыть что ты человек, а не тупой понтушник!

swag, свэг, стиль swag

Security

annotation	description	parameters	example
securitydefinitions.basic		// @securityDefinitions.basic BasicAuth
securitydefinitions.apikey	in, name	// @securityDefinitions.apikey ApiKeyAuth
securitydefinitions.oauth2.application	tokenUrl, scope	// @securitydefinitions.oauth2.application OAuth2Application
securitydefinitions.oauth2.implicit	authorizationUrl, scope	// @securitydefinitions.oauth2.implicit OAuth2Implicit
securitydefinitions.oauth2.password	tokenUrl, scope	// @securitydefinitions.oauth2.password OAuth2Password
securitydefinitions.oauth2.accessCode	tokenUrl, authorizationUrl, scope	// @securitydefinitions.oauth2.accessCode OAuth2AccessCode

parameters annotation	example
in	// @in header
name	// @name Authorization
tokenUrl
authorizationurl
scope.hoge	// @scope.write Grants write access