Cистема классификации моторных масел API () была создана в 1969 году.По системе API установлены три эксплуатационные категории (три ряда) назначения и качества моторных масел:
S (Service) - состоит из категорий качества моторных масел для бензиновых двигателей, идущих в хронологическом порядке.
C (Commercial) - состоит из категорий качества и назначения масел для дизельных двигателей, идущих в хронологическом порядке.
EC (Energy Conserving) - энергосберегающие масла. Новый ряд высококачественных масел, состоящий из маловязких, легкотекущих масел, уменьшающих расход топлива по результатам тестов на бензиновых двигателях.

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

Классы качества API для бензиновых моторов

Класс API SN – утвержден в 1 октября 2010 года.
Основное отличие API SN от предыдущих классификаций API в ограничении содержания фосфора для совместимости с современными системами нейтрализации выхлопных газов, а также комплексное энергосбережение. То есть, масла, классифицируемые по API SN, будут приблизительно соответствовать АСЕА С2, С3, С4, без поправки на высокотемпературную вязкость.

Класс API SM – утвержден 30 ноября 2004 года.
Моторные масла для современных бензиновых (многоклапанных, турбированных) двигателей. По сравнению с классом SL моторные масла, соответствующие требованиям API SM должны обладать более высокими показателями защиты от окисления и преждевременного износа деталей двигателя. Кроме того, повышены стандарты относительно свойств масла при низких температурах. Моторные масла этого класса могут быть сертифицированы по классу энергосбережения ILSAC
Моторные масла, соответствующие требованиям API SL, SM могут применяться в случаях, когда производителем автомобиля рекомендуется класс SJ или более ранние.

Класс API SL – моторные масла для двигателей машин, выпущенных после 2000 года.
В соответствии с требованиями производителей автомобилей, автомасла этого класса применяются в многоклапанных, турбированных моторах, работающих на обеднённых смесях топлива, соответствующих современным повышенным требованиям по экологии, а также энергосбережению. Автомасла, соответствующие требованиям API SL могут использоваться в случаях, когда автопроизводителем рекомендуется класс SJ или более ранние.

Класс API SJ – моторные масла для использования в бензиновых моторах начиная с 1996 года выпуска.
Данный класс описывает автомасла, которые используются в бензиновых двигателях, начиная с 1996 года выпуска. Моторные масла этого класса предназначены для использования в бензиновых моторах легковых и спортивных машин, микроавтобусов и легких грузовых машин, которые обслуживаются в соответствии с требованиями производителей автомобилей. SJ предусматривает такие же минимальные стандарты, как и SH, а также дополнительные требования к нагарообразованию и работе при низких температурах. Моторные масла, удовлетворяющие требованиям API SJ, могут применяться в тех случаях, когда производителем автомобиля рекомендуется класс SH или более ранние.

Класс API SH – моторные масла для бензиновых моторов начиная с 1994 года выпуска.
Класс принят в 1992 году для моторных масел, рекомендуемых с 1993 г. Этот класс характеризуется более высокими требованиями по сравнению с классом SG, и был разработан, как заменитель последнего, для улучшения антинагарных, противоокислительных, антиизносных свойств масел и повышенной защиты от коррозии. Моторные масла этого класса предназначены для использования в бензиновых моторах легковых машин, микроавтобусов и легких грузовых автомобилей, в соответствии с рекомендациями их производителей. Моторные масла данного класса тестировались в соответствии с требованиями Ассоциации производителей химической продукции (СМА). Моторные масла этого класса могут использоваться в тех случаях, когда производителем автомобиля рекомендуется класс SG или более ранний.

Класс API SG – моторные масла для бензиновых моторов начиная с 1989 года выпуска.
Предназначены для использования в бензиновых моторах легковых машин, микроавтобусов и легких грузовиков. Моторные масла этого класса обладают свойствами, обеспечивающими улучшенную защиту от нагара, окисления автомасла и износа мотора, в сравнении с предыдущими классами, а также содержат присадки, защищающие от ржавления и коррозии внутренних деталей двигателя. Моторные масла класса SG соответствуют требованиям к моторным маслам для дизельных моторов API CC и могут использоваться там, где рекомендуются классы SF, SE, SF/CC или же SE/CC.

Класс API SF - моторные масла для бензиновых моторов начиная с 1980 года выпуска (устаревший класс).
Эти моторные масла применялись в бензиновых моторах 1980-1989 годов выпуска, при условии наличия рекомендаций и инструкций производителя двигателя. Обеспечивают усиленную устойчивость к окислению, улучшенную защиту от износа деталей, в сравнении базовыми характеристиками автомасел SE, а также более надежную защиту от нагара, ржавления и коррозии. Моторные масла класса SF могли применяться, как заменители предыдущих классов SE, SD или SC.

Класс API SE - моторные масла бензиновых моторов выпуска с 1972 года (устаревший класс). Эти моторные масла применялись в бензиновых моторах моделей выпуска 1972-79 годов, а также некоторых моделях 1971 г. Дополнительная защита в сравнении с автомаслами SC и SD и могут использоваться, как заменители этих категорий.

Класс API SD - моторные масла для использования в бензиновых моторах с 1968 г. (устаревший класс). Автомасла этого класса использовались в бензиновых моторах легковых машин и некоторых грузовых выпуска 1968-70 годов, а также некоторых моделей 1971 г. и позднее. Улучшенная защита по сравнению с моторными маслами SC, применялись также исключительно при наличии рекомендации производителя двигателя.

Класс API SC - моторные масла для бензиновых моторов, начиная с 1964 г. выпуска (устаревший класс). Обычно применялись в моторах легковых машин и некоторых грузовиков выпуска 1964-1967 годов. Уменьшают высоко- и низкотемпературный нагар, износ, а также защищают от коррозии.

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

Класс API SA - моторные масла для бензиновых и дизельных моторов. Устаревший класс масел для использования в старых моторах, работающих в таких условиях и режимах, при которых защита деталей с помощью присадок не нужна. Моторные масла этой класса могут применяться только, если они рекомендованы производителем двигателя.

Классы качества API для дизельных моторов

Класс API СJ-4 - действует с 1 октября 2006.
Данный класс разработан специально для тяжелонагруженных двигателей. Отвечает ключевым требованиям по нормам выбросов NOx и твердых частиц для двигателей 2007 года выпуска. На масла CJ-4 вводятся лимиты по некоторым показателям: зольность меньше чем 1,0 %, сера 0,4%, фосфор 0,12%.
Новая классификация вмещает требования более ранних категорий API CI-4 PLUS, CI-4, но несет значительные изменения требования в ответ на потребности новых двигателей, которые отвечают новым экологическим стандартам 2007 и более поздних моделей.

Класс API CI-4 (CI-4 PLUS) - новый эксплуатационный класс моторных масел для дизельных двигателей. По сравнению с API CI-4 повышены требования к удельному содержанию сажи, а также испаряемости и высокотемпературному окислению. При сертификации в данной классификации моторное масло должно тестироваться в семнадцати моторных тестах.

Класс API CI-4 - класс введен в 2002 году.
Эти моторные масла применяются в современных дизельных двигателях с различными видами впрыска и наддува. Моторное масло, соответствующее данному классу, должно содержать соответствующие моюще-диспергирующие присадки и имеет, в сравнении с классом CH-4, повышенную устойчивость к термическому окислению, а также более высокие диспергирующие свойства. Кроме того, такие автомасла обеспечивают существенное уменьшение угара моторного масла за счет снижения летучести и уменьшения испарения при рабочей температуре до 370°C, под воздействием газов. Усилены также требования относительно холодной прокачиваемости, увеличен ресурс зазоров, допусков и уплотнений мотора за счет улучшения текучести автомасла.
Класс API CI-4 введен в связи с появлением новых, более жестких требований по экологии и токсичности выхлопных газов, которые предъявляются к двигателям выпускаемым с 1 октября 2002 г.

Класс API CH-4 - действует с 1 декабря 1998 года.
Моторные масла данного класса применяются в четырехтактных дизельных двигателях, которые эксплуатируются в высокоскоростных режимах и соответствуют требованиям норм и стандартов по токсичности выхлопных газов, принятых в 1998 году.
Автомасла API CH-4 соответствуют достаточно жестким требованиям как американских, так и европейских производителей дизельных двигателей. Требования класса специально разработаны для использования в моторах, работающих на высококачественном топливе с удельным содержанием серы до 0,5%. При этом, в отличие от класса API CG-4, ресурс этих моторных масел менее чувствителен к использованию дизельного топлива с содержанием серы более 0,5%, что особенно актуально для стран Южной Америки, Азии, Африки.
Моторные масла API CH-4 соответствуют повышенным требованиям и должны содержать присадки, более эффективно предотвращающие износ клапанов и образование нагара на внутренних поверхностях. Могут применяться, как заменители моторных масел API CD, API CE, API CF-4 и API CG-4 в соответствии с рекомендациями производителя двигателя.

Класс API CG-4 - класс представлен в 1995 году.
Моторные масла этого класса рекомендуются для четырехтактных дизельных двигателей автобусов, грузовых машин и тягачей магистрального и немагистрального типа, которые эксплуатируются в режимах повышенных нагрузок, а также высокоскоростных режимах. Моторное масло API CG-4 подходит для двигателей, в которых используется высококачественное топливо с удельным содержанием серы не более 0,05%, а также в моторах, для которых не выдвигается особых требований к качеству топлива (удельное содержание серы может достигать 0,5%).
Автомасла, сертифицированные по классу API CG-4, должны более эффективно предотвращать износ внутренних деталей двигателя, образование нагара на внутренних поверхностях и поршнях, окисление, пенообразование, образование сажи (эти свойства особенно нужны для двигателей современных магистральных автобусов и тягачей).
Класс API CG-4 создан в связи с утверждением в США новых требований и стандартов по экологии и токсичности выхлопных газов (редакция 1994 года). Моторные масла этого класса могут применяться в двигателях, для которых рекомендуются классы API CD, API CE и API CF-4. Основной недостаток, ограничивающий массовое использование автомасел данного класса, например в восточной Европе и Азии, это существенная зависимость ресурса автомасла от качества используемого топлива.

Класс API CF-2 (CF-II) - автомасла, предназначенные для применения в двухтактных дизельных моторах, которые эксплуатируются в тяжелых условиях.
Класс введен в 1994 году. Моторные масла этого класса обычно используются в двухтактных дизельных двигателях, которые работают в условиях повышенной нагруженности. Масла API CF-2 должны содержать присадки, которые обеспечивают защиту повышенной эффективности от износа внутренних деталей двигателя, например цилиндров и колец. Кроме того, эти автомасла должны предотвращать накопление отложений на внутренних поверхностях мотора (улучшенная функция очистки).
Моторное масло, сертифицированное по классу API CF-2 обладает улучшенными свойствами и может использоваться вместо более ранних аналогичных масел при условии наличия рекомендации производителя.

Класс API CF-4 - моторные масла для использования в четырехтактных дизельных моторах, начиная с 1990 года выпуска.
Моторные масла данного класса могут использоваться в четырехтактных дизельных двигателях, условия эксплуатации которых связаны с высокоскоростными режимами. Для таких условий требования к качеству масел превышают возможности класса СЕ, поэтому моторные масла CF-4 могут использоваться вместо масел класса СЕ (при наличии соответствующих рекомендаций производителя двигателя).
Автомасла API CF-4 должны содержать соответствующие присадки, которые обеспечивают снижение угара автомасла, а также защиту от нагара в поршневой группе. Основное предназначение моторных масел данного класса – применение в дизельных двигателях сверхмощных тягачей и других автомобилей, которые используются для дальних поездок по автомагистралям.
Кроме того, таким моторным маслам иногда присваивается сдвоенный класс API CF-4/S. В таком случае, при условии наличия соответствующих рекомендаций производителя двигателя, эти автомасла могут применяться и в бензиновых двигателях.

Класс API CF (CF-2, CF-4) - моторные масла для дизельных двигателей с непрямым впрыском. Классы введены начиная с 1990-го и по 1994-й года. Цифра через дефис означает двух- или четырехтактный двигатель.
Класс CF описывает моторные масла рекомендованные к применению в дизельных двигателях с непрямым впрыском, а также других видах дизельных двигателей, которые работают на топливе различного качества, в том числе и с повышенным содержанием серы (например, больше 0,5% от общей массы).
Моторные масла, сертифицированные по классу CF, содержат присадки, способствующие более эффективному предотвращению отложений на поршне, износа и коррозии медных (с содержанием меди) подшипников, что имеет большое значение для двигателей этих видов, и могут прокачиваться обычным способом, а также с помощью турбонагнетателя или компрессора. Моторные масла этого класса могут использоваться там, где рекомендуется класс качества CD.

Класс API СЕ - моторные масла для использования в дизельных моторах, начиная с 1983 года выпуска (устаревший класс).
Автомасла данного класса предназначались для использования в некоторых сверхмощных турбированных моторах, характеризующихся существенно повышенной рабочей компрессией. Применение таких масел допускалось для двигателей как с низкой, так и с высокой частотой вращения вала.
Моторные масла API СЕ рекомендовались для низко- и высокооборотистых дизельных двигателей, выпущенных, начиная с 1983 года, которые эксплуатировались в режимах повышенной нагрузки. При условии наличия соответствующих рекомендаций производителя двигателя, эти автомасла могли быть использованы также в моторах, для которых рекомендовались моторные масла класса CD.

Класс API CD-II - моторные масла для использования в сверхмощных дизелях с двухтактным рпабочим циклом (устаревший класс).
Класс введен в 1985 году для использования в двухтактных дизельных моторах и является, по сути, эволюционным развитием предыдущего класса API CD. Основным предназначением использования таких автомасел являлось применение в тяжелых мощных дизельных двигателях, которые устанавливались, в основном на сельскохозяйственную технику. Моторные масла этого класса соответствуют всем рабочим стандартам предыдущего класса CD, кроме этого существенно повышены требования относительно высокоэффективной защиты двигателя от нагара и износа.

Класс API CD - моторные масла для дизельных двигателей повышенной мощности, которые использовались в сельскохозяйственной технике (устаревший класс). Класс введен в 1955 году для обычного использования в некоторых дизельных моторах, как атмосферных, так и турбированных, с увеличенной компрессией в цилиндрах, где крайне важна эффективная защита от нагара и износа. Моторные масла этого класса могли использоваться в случаях, когда производителем двигателя не выдвигались дополнительные требования к качеству топлива (включая топливо с повышенным содержанием серы).
Автомасла API CD должны были, по сравнению с предыдущими классами, обеспечивать повышенную защиту от коррозии подшипников и высокотемпературного нагара в дизельных моторах. Нередко моторные масла этого класса называли «Caterpillar серия 3», благодаря тому, что они соответствовали требованиям сертификации Superior Lubricants (Series 3), разработанной тракторной компанией Катерпиллар.

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

Класс API СВ - моторные масла для дизельных двигателей, работающих со средней нагрузкой (устаревший класс).
Класс утвержден в 1949 г., как эволюционное развитие класса СА при использовании топлива с повышенным содержанием серы без особых требований к качеству. Автомасла API СВ предназначались также для использования в моторах с наддувом, которые эксплуатировались в легком и умеренном режимах. Часто этот класс называли «Моторные масла «Приложение 1», тем самым, подчеркивая соответствие военному предписанию MIL-L-2104A Приложение 1.

Класс API СА - моторные масла для малонагруженных дизельных двигателей (устаревший класс).
Автомасла этого класса предназначены для использования в дизельных моторах, работающих в легких и умеренных режимах на качественном дизельном топливе. В соответствии с рекомендациями производителей автомобилей, могут применяться и в некоторых бензиновых моторах, которые эксплуатируются в умеренных режимах.
Класс широко использовался в 40-х и 50-х годах прошлого века и не может использоваться в современных условиях, если это не предусмотрено требованиями производителя двигателя.
Моторные масла API СА должны обладать свойствами, обеспечивающими защиту от нагара на поршневых кольцах, а также от коррозии подшипников в моторах с наддувом, для которых не предусмотрены особые требования к качеству топлива, которое используется.

Для того, чтобы облегчить труд своих коллег и обеспечить всем программам для Windows универсальный интерфейс, программисты Microsoft создали такую вещь, как API - "Application Programming Interface".

Это - набор функций и процедур, которые могут наиболее часто использоваться программами: отображение дерева каталогов, поиск файлов, отображение стандартного окна с кнопками закрытия, минимизации и развертывания на весь экран и многих других. В итоге разработчик, создающий программу для Windows, не должен продумывать и разрабатывать специальные подпрограммы для отображения окна программы, окна для выбора папки и остальных подобных элементарных операций, - ему достаточно просто вызвать из библиотек kernel32.dll или user32.dll, содержащих функции и процедуры API, нужную ему функцию, а она уже все сделает за него сама. Таких функций и процедур много - порядка 600.

В операционной системе MS-DOS такого понятия, как API, не было, - тот, кто брался писать программу для этой операционной системы, обязан был сам, от начала до конца, продумать и реализовать способы выдачи на экран изображения, получения данных от пользователя, путешествия по файловой системе, рисования графики, если таковая возможность была необходимой 2 . Это делало процесс разработки программ с удобным для пользователя интерфейсом весьма трудоемким процессом, зачастую затраты времени и сил на создание приемлемого графического интерфейса программы превосходили затраты на реализацию собственного алгоритма программы, ради которого она и создавалась. Недаром были очень распространены так называемые "консольные" приложения, то есть программы, работающие только из командной строки, без интерфейса, - ввод данных происходил в той же командной строке или производился из указанного в ней файла, а вывод результатов шел в простом текстовом режиме.

С появлением операционной системы Windows каторжный труд программистов по разработке внешнего вида программы и удобных способов ввода и вывода информации резко облегчился, - уже в Windows 3.0 использовались функции API. Теперь программист, если он, например, желал создать окно ввода текста или полосу прокрутки, должен был всего лишь написать вызов функции отображения такого окна с необходимыми ему параметрами, так же, как и любой другой функции языка, на котором он писал свою программу, а не вводить огромные обьемы кода ради создания программы, заново рисующей такое окно или полосу (сознавая при этом, что при разработке следующей программы, в которой тоже будут использоваться такие объекты, ему придется вновь разрабатывать такой код или пытаться частично использовать старый, приспосабливая его к нуждам этой новой программы). Поэтому появление API совершило революционный прорыв в технологии программирования, позволяя создавать нужные программы с привычным удобным интерфейсом гораздо быстрее, не заботясь о таких рутинных деталях, как программирование стандартных объектов интерфейса для ввода и вывода информации.

В языке Visual Basic for Applications (VBA) многие функции и процедуры API вызываются сами при выполнении программы интерпретатором, так что использовать их для отображения окон ввода и вывода текста, рисования на экране геометрических фигур и других простых действий совершенно нет необходимости, - их VBA вызывает по мере надобности, а программе на нем достаточно использовать соответствующие функции этого языка. Однако иногда возникает необходимость в некоторых действиях, для которых либо нет аналогов во встроенных функциях VBA, либо они работают нерационально или слишком медленно. Например, окно выбора папки с изображением дерева каталогов (рис.5.1) или программа поиска файлов (аналог на функциях VBA - объект "Application.FileSearch" - работает слишком медленно при больших количествах файлов). Для таких случаев в VBA предусмотрена возможность вызова функций API.

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

В подавляющем большинстве случаев при программировании для Office можно обойтись без использования API, но иногда только вызов API-функции может привести к достижению нужного результата. Скажем, вам надо обеспечить вызов разных макросов при простом нажатии мышью кнопки на какой-либо панели инструментов Word и в случае одновременного нажатия этой кнопки и клавиши Shift или Control. Вот фрагмент кода, делающего это:

Declare Function GetAsyncKeyState Lib "user32.dll" (ByVal kState As Long) As Integer

GetAsyncKeyState (vbKeyShift Or vbKeyControl)

If GetAsyncKeyState(vbKeyShift) Then

Call macro1: Exit Sub

ElseIf GetAsyncKeyState(vbKeyControl) Then

Call macro2: Exit Sub

Первая строчка - это как бы "резервирование" функции API для использования в программе на VBA. Видно, что вызывается функция GetAsyncKeyState из библиотеки (файла, содержащего программы, предназначенные только для использования другими программами) user32.dll, причем в эту функцию передается номер клавиши, а возвращает она целое число (а именно - 0, если клавиша с соответствующим номером не нажата, и -32767 или 1, если нажата). Любую функцию или процедуру, вызываемую из библиотек, не относящихся к VBA, необходимо так резервировать с помощью команды Declare.

Фраза vbKeyShift в команде - это заменитель кода клавиши Shift (его значение - 16), а vbKeyControl, как нетрудно понять - заменитель кода клавиши Control. Структура инструкций "If…Then", думается, ясна 3 , а если нет - посмотрите в справке VBA. Команда Call перед именем макроса, как вы помните, означает его запуск.

В Интернете есть русские сайты, посвященные API 4 . Посетите их, чтобы узнать больше об этом наборе функций.

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

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

Что позволяет делать API платформы beseller?

Цель создания API платформы beseller - предоставление сторонним приложениям возможности взаимодействия с сайтами и базами данных интернет-магазинов.

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

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

Информации об оформленных заказах

Доступные действия (методы) обработки информации о заказах:

1. Выбор информации о заказе по ID
2. Выбор информации о заказах по фильтру
3. Количество заказов по фильтру
4. Создание заказа
5. Удаление заказа
6. Массовое удаление заказов
7. Выбор всех доступных статусов для заказов
8. Обновление статуса заказа
9. Добавление комментария к заказу

Информации о подписчиках

1. Добавление подписчика
2. Удаление подписчика
3. Массовое удаление подписчиков
4. Выбор данных о подписчиках по фильтру
5. Количество подписчиков по фильтру

Информации о зарегистрированных пользователях

Доступные действия (методы) обработки информации о подписчиках:

1. Выбор информации о зарегистрированных пользователях по ID
2. Выбор информации обо всех зарегистрированных пользователях
3. Выбор информации обо всех данных указанных пользователем при регистрации:
   • Фамилия, имя, отчество;
   • Контактный адрес электронной почты;
   • Контактный номер телефона;
   • Указанный адрес доставки: индекс, название населенного пункта, название улицы, номер дома, номер корпуса, номер квартиры, этаж;

Обратите внимание! При регистрации, пользователь может не заполнить все указанные выше поля.

Планы по развитию API

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

1. Разделами каталога.
2. Товарами.
3. Корзиной.
4. Скидками.
5. Способами доставки.
6. Способами оплаты.

Для тестирования взаимодействия с API платформы beseller создан тестовый магазин beseller-api.shop.by .

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

Перед тестированием взаимодействия с API мы рекомендуем вам:

1. оформить самостоятельно несколько заказов;
2. подписаться на рассылку;
3. посмотреть как информация об оформленных заказах и подписчиках отображается в панели администрирования магазина.

Панель управления магазином доступна по адресу: beseller-api.shop.by/manager/ . Логин и пароль при входе в панель управления аналогичны логину и паролю доступа к магазину.

Как подключиться по API к своему магазину?

Для связи приложения с вашим магазином необходимо указать url-адрес доступа к API вида:

http://адрес_вашего_сайта:8082/graphql?token=ваш_персональный_секретный_ключ

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

Функции и переменные GraphQL для работы с API платформы beseller

Как подключиться к API с использованием языка программирования PHP

Для удобства работы с API платформы beseller вы можете воспользоваться:

1. Классами разработанными нами под PHP.
   1. GraphqlClient - осуществляет прием и передачу данных на сервер;
   2. GraphQlHelper - содержит в себе реализованные query и mutation API;
2. Примерами использования классов для осуществления выборок и изменений в базе данных интернет-магазина.

Настройка локального окружения

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

В качестве локального окружения используется GraphiQL Feen , это расширение для браузера Google Chrome которое позволяет формировать запросы к API.

После установки приложения у вас в браузере возле адресной строки появится иконка приложения.

Откройте приложение GraphiQL Feen и перейти на вкладку «SERVERS», выберите метод отправки POST, после чего укажите url-адрес доступа к API.

В качестве тестового url необходимо использовать следующий адрес:

Локальное окружение настроено, можно формировать запросы к API. Для этого необходимо открыть вкладку «QUERIES»

Формирование запроса к API beseller при помощи GraphiQL Feen и полученный ответ

Пояснения к скриншоту:

1. Сохраненные запросы
2. Поле для ввода запросов
3. Поле ввода переменных
4. Полученный ответ
5. Кнопка запуска

Пример запроса на получение списка оформленных заказов за указанный промежуток времени

query ($first:Int, $offset:Int, $filter: OrdersFilterType){
orders(first:$first, offset:$offset, filter:$filter){
comment
status{
id
description
name
}
create_date
update_date
total {
suffix
value
}
payment {
name
description
cost {
suffix
value
}
}
delivery {
name
description
cost {
suffix
value
}
}
currencies {
bank_code
course
suffix
}
user_data {
name
description
value
}
}
}

Указание промежутка времени для выборки данных об оформленных заказах

{
"filter": {
"date_after": "2017-11-16T00:00:01Z",
"date_before": "2017-11-23T00:00:01Z"
}
}

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

{{
"data": {
"orders": [
{
"comment": "Culpa officiis vel ut.",
"create_date": "2017-11-22 16:23:28",
"currencies": [
{
"bank_code": "BYN",
"course": 10000,
"suffix": "руб."
}
],
"delivery": {
"cost": [
{
"suffix": "руб.",
"value": 0
}
],
"description": "Курьер",
"name": "custom"
},
"payment": {
"cost": [
{
"suffix": "руб.",
"value": 0
}
],
"description": "Пластиковые карты",
"name": "custom"
},
"status": {
"description": "Новый",
"id": 1,
"name": "new"
},
"total": [
{
"suffix": "руб.",
"value": 4450
}
],
"update_date": "2017-11-22 16:23:28",
"user_data": [
{
"description": "Адрес e-mail",
"name": "email",
"value": "[email protected]"
},
{
"description": "Телефон",
"name": "phone",
"value": "784.392.3949 x69329"
},
{
"description": "Адрес",
"name": "registration",
"value": "607 Erik Station Suite 057\nReynaberg, WY 83542-0037"
},
{
"description": "Комментарий",
"name": "comment",
"value": "Id nam illo optio."
},
{
"description": "ФИО",
"name": "fio",
"value": "Jordi Mann MD"
}
]
}

Начнем с основ: что такое API? Аббревиатура расшифровывается как Application Programming Interface, или интерфейс для программирования приложений. Название, вроде бы, говорит само за себя, но лучше рассмотреть более детальное объяснение.

Как уже было сказано, API – это, в первую очередь, интерфейс. Интерфейс, который позволяет разработчикам использовать готовые блоки для построения приложения. В случае с разработкой мобильных приложений в роли API может выступать библиотека для работы с "умным домом" – все нюансы реализованы в библиотеке и вы лишь обращаетесь к этому API в своём коде.

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

API в веб-приложениях на примерах

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

Подобным образом можно посылать запрос на любом языке, в том числе и на Ruby. Ответом на запрос будет примерно такая информация:

{ "login" : "Freika" , "id" : 3738638, "avatar_url" : "https://avatars.githubusercontent.com/u/3738638?v=3" , "gravatar_id" : "" , "url" : "https://api.github.com/users/Freika" , "html_url" : "https://github.com/Freika" , "followers_url" : "https://api.github.com/users/Freika/followers" , "following_url" : "https://api.github.com/users/Freika/following{/other_user}" , "gists_url" : "https://api.github.com/users/Freika/gists{/gist_id}" , "starred_url" : "https://api.github.com/users/Freika/starred{/owner}{/repo}" , "subscriptions_url" : "https://api.github.com/users/Freika/subscriptions" , "organizations_url" : "https://api.github.com/users/Freika/orgs" , "repos_url" : "https://api.github.com/users/Freika/repos" , "events_url" : "https://api.github.com/users/Freika/events{/privacy}" , "received_events_url" : "https://api.github.com/users/Freika/received_events" , "type" : "User" , "site_admin" : false , "name" : "Evgeniy" , "company" : "" , "blog" : "http://frey.su/" , "location" : "Barnaul" , "email" : "" , "hireable" : true , "bio" : null, "public_repos" : 39, "public_gists" : 13, "followers" : 15, "following" : 21, "created_at" : "2013-03-01T13:48:52Z" , "updated_at" : "2014-12-15T13:55:03Z" }

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

Одного API недостаточно

Создать полноценный API для своего приложения – лишь половина дела. Как вы предполагаете обращаться к API? Как к нему будут обращаться ваши пользователи?

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

Еще раз воспользуемся Github для приведения примера: для работы с АПИ этого прекрасного сервиса (а интерфейс у него предоставляет обширнейшие возможности) создано несколько библиотек на различных языках, например гем Octokit . В документации к таким библиотекам (и приведенному в качестве примера гему) любой заинтересованный разработчик сможет отыскать все необходимые способы получения информации от Гитхаба и отправки её обратно через API сервиса.

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

Полезные ссылки

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

Мы выпустили новую книгу «Контент-маркетинг в социальных сетях: Как засесть в голову подписчиков и влюбить их в свой бренд».

Подписаться

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

Что значит API

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

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

API интерфейс позволяет не тратить свое время, деньги и силы на покупку «нового велосипеда». Вы получаете работающий информационный порт, получающий и отдающий необходимые объемы данных в целях вашей разработки.

Плюсы:

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

Минусы:

• В случае обновления целевого сервиса, API не всегда мгновенно получает полный функционал.
• Вы не можете отловить ошибки и не знаете, как проходит процесс в чужом коде.
• Не всегда API даёт максимально оптимизированный результат по времени, так как предназначено для обработки общих случаев, а не частных.

Примеры API

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

VKAPI

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

Все запросы осуществляются к адресу https://api.vk.com/method/

После слэша идёт наименование используемого API-метода и передаются GET-параметры запроса. Ответ так же приходит по HTTPS в формате JSON.

TELEGRAM BOT API

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

Запросы осуществляются по адресу https://api.telegram.org/bot0000000:token/

Где вместо bot0000000 ставится уникальный идентификатор вашего бота, а token выражает секретный ключ.

Запросы посылаются через HTTPS соединения, название метода указывается через слэш к основному адресу. Ответ приходит в формате JSON.

OPEN WEATHER MAP API

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

Формат работа: HTTP передача по api.openweathermap.org/data/2.5/weather?id= c указанием идентификационного номера желаемого города. Ответ сервера: JSON.

GOOGLE MAPS API

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

Подобные возможности предлагает JavaScript API Google Maps. Модуль полностью скриптовой и работает на стороне браузера, поэтому HTTP-запросы из PHP и формирование заголовков на стороне сервера, как было в других API, нам не нужно.

Например, выставление метки на карте будет выглядеть так:

var mark = new google.maps.Marker({
position: myPOS,
map: map,
title:"Hello!"
});

Для чего нужно и чем полезно использование API

Полезных функций довольно много.

Первый аспект

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

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

Второй аспект

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

• Большой поток клиентов.
• Упрощенный доступ к вашим услугам для партнеров.
• Удобство статистического анализа использования сервиса.

Третий аспект

Почти тот же, что и второй. Но без необходимости реализовывать API для открытого доступа. Если у вас есть портал, и вы хотите создать под него мобильное приложение на Android/IOS, то переписать систему под единое API – лучшее решение. Вся структура данных систематизируется. Сайт и приложение будут работать через единые каналы данных.