Що таке функції api. Як підключитися до API за допомогою мови програмування PHP. Що означає API

У вас є собака. Але вона не розмовляє людською мовою. Однак вона здатна "розуміти" його шляхом команд, яким її навчили у процесі дресирування. Якщо сказати песику, який знає команду "тапки!" щось типу "Рексик, принеси мені, пжалста, тапулі мої із зайчиками", він хіба що на прізвисько вухом поведе, але тапки не принесе. Так ось, API - це набір команд, за допомогою яких ваш песик вас розуміє та робить те, що вам потрібно. Це дуже спрощено і для чайника, але суть зрозуміла, гадаю.

API це мова, регламентований спосіб спілкування однієї комп'ютерної програми з іншою для спільного виконання якої-небудь загального завданняколи одна програма виконує запити інший. Application Programming Interface (API) - Інтерфейс програмування програм.

Ось яка примітивна аналогія для чайників народилася навскідку.

Уявіть собі 5 іноземців, які розмовляють різних мовах, яким потрібно працювати та жити разом, скажімо в Росії. Жоден з них не знає мови іншої, при цьому їм потрібно єдиною командою, за ролями, виконати якесь завдання, наприклад, нагодувати один одного і обговорити смак їжі російською мовою. Для цього потрібно придбати продукти, приготувати їжу, накрити на стіл і за їжею обговорити страви. Щоб вони зрозуміли один одного і змогли знайти продукти у зовнішньому світі, навчимо їх базового наборуросійських слів. Уявимо, що у нас є:

1. Француз

2. Іспанець

4. Англієць

5. Італієць

Розподілимо з-поміж них ролі до виконання подзадач в такий спосіб

Купівля їжі: Француз та Іспанець

Страви: Іспанець, Німець та Англієць

Сервірування Столу: Англієць та Італієць

Трапеза та обговорення смаку Страви: ВСЕ

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

Так ось. Група наших іноземних друзів – це група комп'ютерних програм , яким потрібно спілкуватися між собою та із зовнішнім середовищем.

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

API 1: Слова, що позначають Продукти та Де Купити
API 2: Слова, що позначають Страви та Способи приготування
API 3: Слова, що позначають Прилади та Дії з ними
API 4: Слова, що позначають Смак та Оцінку Їжу

Може бути і складніше, наприклад, нехай API 2 це буде турецька мова, API 3 це китайська мова, API 4 це хінді

Приклад для чайників:

1. Є розетка. За нею величезна кількість техніки ховається. Але щоб їй користуватися - треба мати вилку з відстанню між стрижнями 3см і розетка віддасть 220в. Це і є API інтерфейсВеличезної системи електровиробництва.

2. А є праска. У нього своя складна системароботи. Але щоб працювати з розеткою, він дотримується вимог API - потрібна вилка з відстанню 3см і у відповідь чекає 220вольт.

І все. 2 системи незалежні, вони величезні та складні. Але API робиться, щоб максимально просто з'єднатися один з одним.

API - application programming interface. Це певний набір функцій, констант, класів і, можливо, інших об'єктів, взаємодії з деяким шматком програми.

Думаю, що найзрозуміліше буде описати на прикладі. Допустимо, хтось написав калькулятор, який ви хочете використати у своїй програмі. До цього калькулятора треба якось звертатися. Ось ці методи взаємодії з калькулятором і будуть називатися API. Вони ж можуть бути різними, і без їхнього опису нічого зробити не вийде. Може, у вас буде функція для запису числа на згадку, інша для виконання дії, третя для отримання результату. А може, у вас буде одна функція, яка передасть два числа і код операції між ними, і відразу поверне відповідь.

Такі описи складаються для всього. В операційній системі є API, це набір функцій, за допомогою якого створюється програма: мережне з'єднаннянамалювати вікно, обробити натискання кнопки. Якийсь сервер API має набір функцій, які він виконує. Браузер звертається до сайту вікіпедії – він використовує API, щоб повернути вам відповідь на запит.

API визначає функціональність, яку надає програма (модуль, бібліотека), при цьому API дозволяє абстрагуватись від того, як саме ця функціональність реалізована.

Якщо програму (модуль, бібліотеку) розглядати як чорну скриньку, то API – це безліч «ручок», які доступні користувачеві даної скриньки, які він може крутити і смикати.

Програмні компоненти взаємодіють один з одним за допомогою API. При цьому компоненти зазвичай утворюють ієрархію - високорівневі компоненти використовують API низькорівневих компонентів, а ті, у свою чергу, використовують API ще більш низькорівневих компонентів.

За таким принципом побудовано протоколи передачі даних. Стандартний протокол Internet (мережева модель OSI) містить 7 рівнів (від фізичного рівняпередачі пакетів біт рівня протоколів додатків, подібних протоколів HTTP і IMAP). Кожен рівень користується функціональністю попереднього рівня передачі і, своєю чергою, надає потрібну функціональність наступного рівня.

Поняття протоколу близьке за змістом до поняття API. І те й інше є абстракцією функціональності, тільки в першому випадку йдеться про передачу даних, а в другому - про побудову комп'ютерних програм.

API бібліотеки функцій і класів включає опис сигнатурі семантики функцій.

Application Programming Interface (API) програмний інтерфейс взаємодії між системами, що дозволяє:

  • Отримувати доступ до бізнес-сервісів підприємства
  • Обмінюватися інформацією між системами та додатками
  • Спростити взаємодію між компаніями, партнерами, розробниками та клієнтами

Open API стратегія

API стратегія включає:

  • Розробка бізнес-продуктів на основі існуючих API
  • Надання внутрішніх сервісів розробникам
  • Моделі монетизації API для побудови мультиканальної взаємодії та підвищення прибутку

Реалізація концепції Open API допомагає трансформувати бізнес, вбудовувати його у гнучку проектну екосистему гравців ринку, створювати умови для постійної генерації нових ідей та формування додаткової цінності під час управління масивами корпоративних даних.

Ринок інтеграційних рішень розвивається у тих еволюції API - від EDI і SOAP до Web 2.0 , з якого почалася епоха громадських API. Число таких інтерфейсів у найближчі 3 роки може зрости більш ніж у 50 разів і досягти 1 мільйона. Це пов'язано з мультиканальністю: канали взаємодії з клієнтами мають змінюватись разом із ними. Безперервне зростання кількості споживачів та обсягу даних призвело до появи економіки API, що допомагає на основі відкритих інтерфейсівстворювати інноваційні бізнес-моделі використання корпоративних активів та сервісів.

Сигнатура функції

Сигнатура функції- Частина загального оголошення функції, що дозволяє засобам трансляції ідентифікувати функцію серед інших. У різних мовах програмування існують різні уявлення про сигнатуру функції, що й тісно пов'язані з можливостями навантаження функції у цих мовах.

Іноді розрізняють сигнатуру викликуі сигнатуру реалізаціїфункції. Сигнатура виклику зазвичай складається за синтаксичною конструкцією виклику функції з урахуванням сигнатури області видимості даної функції, імені функції, послідовності фактичних типів аргументів у виклику та типі результату. У сигнатурі реалізації зазвичай беруть участь деякі елементи із синтаксичної конструкції оголошення функції: специфікатор області видимості функції, її ім'я та послідовність формальних типів аргументів.

Наприклад, у мові програмування Сі++ проста функціяоднозначно пізнається компілятором з її імені та послідовності типів її аргументів, що становить сигнатуру функції у цій мові. Якщо функція є методом деякого класу, то в сигнатурі братиме участь і ім'я класу.

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

Наприклад: щоб побачити у браузері рядок «Hello, world!» достатньо лише створити HTML-документ з мінімальним заголовком, і найпростішим тілом, що містить цей рядок. Що станеться, коли браузер відкриє цей документ? Програма-браузер передасть ім'я файлу (або вже відкритий дескриптор файлу) бібліотеці, що обробляє HTML-документи, та, у свою чергу, за допомогою API операційної системи прочитає цей файл, і розбереться в його пристрої, що викликає через API бібліотеки стандартних графічних примітивів операції типу «очистити віконце», «написати обраним шрифтом Hello, world!», при цих операціях бібліотека графічних примітивів звернеться до бібліотеки віконного інтерфейсу з відповідними запитами, вже ця бібліотека звернеться до API операційної системи із запитами виду «а поклади мені в буфер відеокарти ось це".

При цьому практично на кожному рівні реально існує кілька можливих альтернативних API. Наприклад: ми могли б писати вихідний документ не на HTML, а на LaTeX, для відображення могли б використовувати будь-який браузер. Різні браузери, Загалом кажучи, використовують різні HTML-бібліотеки, і, крім того, все це може бути (взагалі кажучи) зібрано з використанням різних бібліотек примітивів та на різних операційних системах.

Основними складнощами існуючих багаторівневих систем API, таким чином, є:

  • Складність портування програмного кодуз однієї системи API в іншу (наприклад, при зміні ОС);
  • Втрата функціональності при переході з нижчого рівня на вищий. Грубо кажучи, кожен шар АPI створюється для полегшення виконання деякого стандартного набору операцій. Але при цьому реально утруднюється або стає принципово неможливим виконання деяких інших операцій, які надає нижчий рівень API.

Основні типи API

Внутрішні API

  • Доступ до API надається лише внутрішнім розробникам
  • Програми націлені на працівників підприємства

Бізнес-драйвери:

  • Консистентність розробки
  • Зниження витрат
  • Підвищення ефективності розробки

Партнерські API

  • API доступні лише обмеженому набору бізнес-партнерів
  • Програми призначені для кінцевих споживачів та для бізнес-користувачів

Бізнес-драйвери:

  • Автоматизація процесу розробки
  • Розвиток партнерських відносин
  • Оптимізація процесу взаємодії з партнерами

Публічні API

Доступ надається будь-якому зовнішньому розробнику Програми націлені на кінцевих користувачів

Бізнес-драйвери:

  • Розробка нових сервісів
  • Розвиток екосистеми
  • Мультиканальна взаємодія

Найбільш відомі API

API операційних систем

API графічних інтерфейсів

  • Direct3D (частина DirectX)
  • DirectDraw (частина DirectX)

Ми випустили нову книгу«Контент-маркетинг у соціальних мережах: Як засісти в голову передплатників та закохати їх у свій бренд».

Підписатися

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= ідентифікаційного номерабажаного міста. Відповідь сервера: 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 - краще рішення. Уся структура даних систематизується. Сайт та програма будуть працювати через єдині канали даних.

Настав час поговорити про таке поняття як API функції в мові Visual Basic. Чим же важливі ці функції Visual Basic? Давайте розберемося, по-перше, коли Ви почнете програмувати на Visual Basic, Ви відразу ж зрозумієте, що з використанням цих функцій можна написати дуже серйозні програми, по-друге, багато що не можна зробити без використання API функцій, наприклад, практично все що пов'язано з використанням операційної системи Windows ( наприклад: дізнатися ім'я користувача, місце на жорсткому диску і так далі).

Але для того щоб почати застосовувати на практиці ці функції, Вам потрібно знати, що вони собою представляють, давайте поговоримо спочатку про це.

Теорія з API функцій Visual Basic

API– це абревіатура Application Programming Interface ( інтерфейс прикладного програмування ). Іншими словами, API - це набір функцій, які сама операційна система дає програмісту для використання їх у своїх програмах. За допомогою API програмісти легко реалізують свої задуми практично.

Функції API можуть викликатися з Visual Basic для виконання завдань, для яких недостатньо стандартного програмного коду Visual Basic. Наприклад, стандартні засоби Visual Basic не дозволяє вимкнути комп'ютер або перезавантажити його. Однак це можна легко зробити через звернення до відповідної функції API.

Майже всі функції, які розташовуються в Windows - знаходяться всередині DLL ( Dynamic Link Library). Всі dll-файли розташовані в системній папці Windows. Існує понад 1000 функцій API, які умовно поділяються на чотири основні категорії.

  • Робота з програмами - запуск та закриття програм, обробка команд меню, переміщення та зміни розміру вікон;
  • Графіка – створення зображень;
  • Системна інформація – визначення поточного диска, обсяг пам'яті, ім'я поточного користувача тощо;
  • Робота з реєстром – маніпуляції з реєстром Windows.

Застосування API функцій практично

Тепер перейдемо безпосередньо до використання цих функцій практично. Функції API, що викликаються Visual Basic, повинні бути спочатку оголошені. При оголошенні вказується ім'я DLL та функції, а також інформація про кількість та тип аргументів.

Процедури DLL оголошуються командою Declare у секції General Declarations модуля форми або стандартного модуля:

Declare Function ім'я Lib "бібліотека" [([ _ змінна [,ByVal,] змінна ]...])] As тип

Процедури DLL, які перебувають у стандартних модулях, за замовчуванням є відкритими і можуть бути викликані з будь-якої точки програми. Процедури, оголошені в модулі форми, є закритими і перед їх оголошенням має стояти ключове словоПриватний.

Секція Lib повідомляє, де слід шукати файл DLL, який містить функцію. При посиланні на основні бібліотеки Windows (user32.dll, kernel32.dll, gdi.dll) розширення включати необов'язково.

Якщо шлях до файлу не вказано, то починається перегляд каталогів у наступній послідовності

  1. Каталог, який містить EXE-файл програми;
  2. Поточний каталог;
  3. Системний каталог Windows;
  4. Каталог Windows;
  5. Змінне оточення Path.

Ось невеликий перелік стандартних бібліотек DLL Windows:

  • advapi.dll - захист NT, реєстр та інші просунуті сервіси;
  • comdlg.dll – стандартні діалогові вікна;
  • gdi.dll – інтерфейс графічних пристроїв;
  • kernel32.dll – пам'ять, диски, процеси, ресурси;
  • mpr.dll - мережі;
  • netapi32.dll – бібліотека мережевого API;
  • shell32.dll - оболонка Windows, drag-and-drop, вибірка значків;
  • user32.dll - інтерфейс користувача-вікна, меню, рядки, повідомлення;
  • version.dll – контроль версій;
  • winmm.dll – мультимедіа, звук, джойстики, таймери;
  • winspoll.dll – диспетчер друку.

Більшість процедур DLL документовано з використанням нотації мови програмування C і C++. Для успішного перетворення функції API у команду Declare необхідно знатися на механізмі передачі аргументів. Зазвичай аргументи передаються за значенням. У цьому випадку перед ім'ям аргументу ставиться ключове слово ByVal. Якщо аргумент передається за посиланням, ставиться ByRef.

Ось найменший список функцій, які використовуються у Visual Basic:

  • BitBlt - копіює зображення з одного hDC до іншого;
  • FindWindow - знаходить Handle вікна із зазначеним Caption;
  • GetCursorPos – повертає поточну позицію курсора миші (глобально);
  • GetDriveType – повертає тип накопичувача;
  • GetForegroundWindow - повертає Handle активного вікна;
  • SetCursorPos – встановлює нову позицію курсора миші;
  • SetVolumeLabel – змінює мітку диска;
  • SetWindowPos - встановлює позицію вікна з певним Handle (також за допомогою цієї функції можна зробити так, щоб вікно було ПОВЕРХ всіх;
  • ShellExecute - запускає програму, асоційовану з розширенням, яка має вказаний файл(також може просто запустити вказану програму);
  • ShowCursor – приховує або показує курсор миші на екрані.

Приклади роботи з реєстром

Також при програмуванні на Visual Basic, та й іншими мовами виникає проблема, коли потрібно використовувати реєстр Windows, але з допомогою apiфункцій це зробити легко, наприклад:

Щоб прочитати рядковий параметр, використовуйте функцію GetRegString

Приклад:

Dim test As String test = GetRegString(HKEY_LOCAL_MACHINE, _ "Software\Microsoft\DirectX", "Version") Form1.Caption = test

Для читання параметра DWORD GetRegDWord

Приклад:

Dim test As Long test = GetRegDWord(HKEY_LOCAL_MACHINE, _ "Software\Microsoft\Internet Explorer\AboutURLs", "Home") Form1.Caption = test

Для запису рядкового параметра використовується SetRegString

Приклад:

SetRegString HKEY_LOCAL_MACHINE, _ "Software\test", "MyProgram", "Options"

Якщо ключ або параметр не були створені, вони будуть створені, якщо ключ або параметр вже існують, то нові значення запишуться поверх старих.

Для запису типу DWORD використовується SetRegDWord

Приклад:

SetRegDWord HKEY_LOCAL_MACHINE, _ "Software\test", "MyProgram", "555"

Для видалення ключа із реєстру використовується функція DeleteRegKey

Приклад:

DeleteRegKey HKEY_LOCAL_MACHINE, "Software", "test", True

Другий параметр - Ключ-батько
Третій параметр - True - якщо потрібно підтвердження видалення або False - якщо підтвердження не потрібно.

Для видалення параметра з реєстру використовується функція DeleteRegValue

Приклад:

DeleteRegValue HKEY_LOCAL_MACHINE,_ "Software\Microsoft\Internet Explorer\AboutURLs", "mozilla", False

Насправді, можливості API функцій в операційній системі Windows практично безмежні. Давайте закінчимо цьому розгляд цієї можливості Visual Basic і наостанок напишемо маленьку програму з допомогою API функцій.

Ця програма просто виводить повідомлення на екран, вставте наступний код:

Private Declare Function BeginPath Lib "gdi32" (ByVal hdc As Long) As Long Private Declare Function EndPath Lib "gdi32" (ByVal hdc As Long) As Long Private Declare Function PathToRegion Lib "gdi32" (ByVal Function SetWindowRgn Lib "user32" (ByVal hWnd As Long, ByVal hRgn As Long, ByVal bRedraw As Boolean) As Long Private Sub Form_Load() Const TEXT = "Ти використовував API" Dim hRgn As Long Font.Name = "Times New Roman Font.Bold = True Font.Size = 60 Width = TextWidth(TEXT) Height = TextHeight(TEXT) BeginPath hdc Print TEXT EndPath hdc hRgn = PathToRegion(hdc) SetWindowRgn hWnd, hRgn, False Move (Screen) , (Screen.Height - Height) / 2 End Sub

Ми тут використовували 4 функції (BeginPath, EndPath, PathToRegion, SetWindowRgn), які розміщуються у двох dll бібліотеках(gdi32, user32).

На цьому все, поки що!

Система класифікації моторних масел 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 СА повинні мати властивості, що забезпечують захист від нагару на поршневих кільцях, а також від корозії підшипників у моторах з наддувом, для яких не передбачені особливі вимогидо якості палива, що використовується.