Site icon База знань Snov.io

Як користуватися Snov.io API

Опис:

Автоматизувати задачі доволі легко — для цього вам необіхно інтегрувати Snov.io безпосередньо у свою платформу, а ми зі свого боку надаватимемо email-адреси з нашої бази даних. Snov.io REST API робить все можливим!

Що таке API і як він працює

Давайте швидко пройдемося по основах API, познайомимося з тим, що це взагалі таке і як він працює.

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

Щоб уявити, що таке API на конкретному прикладі, давайте уявимо чат. Так, звичайний чат, де одна програма або програмне забезпечення запитує щось у іншої програми та отримує відповідь у режимі реального часу. А єдиний спосіб спілкуватися в цьому чаті — надсилати заздалегідь визначені «запитання» або «команди» (виклики API), тоді як сервер надсилає відповідь.

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

Чотири найпоширеніші методи запиту API:

Якщо клієнт (ви) ставить правильне запитання з правильними параметрами, сервер (Snov.io) поверне дані, що запитуються, або відповідь, яка підтверджує виконання запитаної дії.

Переваги Snov.io API

Snov.io API надає чудову можливість розширити функціональність вашого додатка або вебсайту.

За допомогою Snov.io API ви можете:

Тип Snov.io API — REST, що робить його надзвичайно простим у користуванні. У REST API дані та функції представлені у вигляді ресурсів,  що доступні як унікальні URL-адреси. Щоб попросити Snov.io поділитися даними через API, вам просто потрібно ввести URL-адресу, встановити параметри запиту та автентифікувати його.

Як перевірити Snov.io API

Найпростіший спосіб побачити, як працює Snov.io API, — це скористатися тестовим інструментом. Аби продемонструвати роботу Snov.io API, ми використовуватимемо Postman, оскільки цей інструмент добре відомий, відносно простий у використанні та має безплатну версію.

Давайте зробимо ваш перший виклик API до Snov.io від Postman!

Крок 1. Реєстрація в Postman

Зареєструйтеся в Postman на офіційному веб-сайті та створіть обліковий запис.

У вкладці «Home» (1) натисніть кнопку «Send a request» (2), щоб перейти до середовища тестування API.

Крок 2. Загальні налаштування виклику API

Кожен запит до Snov.io API містить:

Ось де ввести налаштування виклику API в середовищі тестування Postman:

Порада: для запитів GET введіть вхідні параметри у вкладці «Params». Для запитів POST введіть вхідні параметри у вкладці «Body»→ вкладка «form-data».

Крок 3. Отримання токена доступу API

Перш ніж зробити запит, вам необхідно згенерувати токен доступу для автентифікації ваших майбутніх викликів API до Snov.io та ідентифікувати себе як клієнта Snov.io у «чаті» Snov.io API.

Токен доступу — це ваша особиста «пропускна картка», яку вам потрібно пред’являти щоразу, коли ви здійснюєте виклик через API до Snov.io.

У кожному запиті до Snov.io API цей токен доступу потрібно вказувати в полі «Autorization» (нижче ми пояснюємо, як це зробити в Postman).

Налаштування виклику токена доступу API:

Ключ Значення
grant_type (1) client_credentials
client_id (2) ID користувача, який ви можете знайти в налаштуваннях акаунту
client_secret (3) Ключ API, який ви можете знайти в налаштуваннях акаунту

Після того, як ви ввели всі параметри, клікніть «Send» (1) та отримайте токен доступу (Access token) (2) у розділі «Output/Reponse». Збережіть його або скопіюйте, щоб надалі використовувати його для викликів API.

Примітка №1. В цілях безпеки тривалість існування токену доступу обмежена 3600 секундами (1 година). Вам буде необхідно щогодини генерувати новий токен доступу.

Примітка №2. Тип токену — Bearer. Вам буде необхідно уточнити тип токену під час авторизації наступного запиту.

Тепер ознайомимося з кількома викликами API, які ви можете відправити в Snov.io API.

Крок 4. Здійснення тестового виклику API

Ви можете попросити Snov.io API надати до 100 email-адрес з домену за один виклик. Вартість становить 1 кредит за 10 email-адрес/потенційних клієнтів, наданих у відповідь.

Щоб автентифікувати свій виклик API у Postman:

Перейдіть на вкладку «Authorization» (1) у Postman, виберіть тип токену «Bearer Token» (2) і вставте токен доступу (3).

Поверніться до вкладки «Params», щоб ввести налаштування виклику API «Пошук за доменом»:

Ключ Значення
domain Домен, з якого ви хочете отримати email-адреси.
type Усі, персональні, чи загальні.
limit Кількість адрес, яку ви хочете отримати з домену (максимальне значення складає 100).
lastId Значення за замовчуванням — 0. Щоб отримати понад 10 адрес пошти з домену, у наступному запиті укажіть значення відповіді last_id з попереднього запиту.
position or positions Укажіть конкретні посади, щоб відфільтрувати контакти.

Примітка № 1. Якщо ви даєте запит на загальні email-адреси, ви отримаєте адреси на основі посад, наприклад contact@snov.io. Особисті адреси електронної пошти – це email-адреси людей, які працюють у компанії. Якщо ви вкажете «all» як тип, ви отримаєте як особисті, так і загальні email-адреси.

Примітка №2. Щоб отримати понад 100 email-адрес з домену, у своєму наступному запиті вкажіть значення відповіді last_id з попереднього запиту.

Після введення всіх налаштувань натисніть кнопку «Send», щоб побачити адреси пошти, які має Snov.io.

За допомогою Snov.io API ви можете перевірити, чи валідні вказані адреси пошти. Цей виклик API безплатний.

Спочатку переконайтеся, що ви автентифікували свій виклик API за допомогою токена доступу у вкладці «Authorization».

Далі відкрийте вкладку «Body»→ вкладку «form data» в Postman і введіть параметри виклику API «Верифікація адрес»:

Після введення всіх параметрів натисніть кнопку «Send», щоб побачити статус email-адреси в розділі «Output/Response»: «valid», «not_valid», «greylisted» або «unknown».

Якщо ви отримуєте ідентифікатор «not_verified» у полі «Output/Response», це означає, що ми ще не перевіряли цю email-адресу. Ви повинні скористатися викликом API «Додати адреси для перевірки», щоб верифікувати цю адресу пошти (1 кредит за одну адресу), а потім повторити виклик API «Верифікація адрес» (безплатно), щоб побачити результати перевірки.

Виклики Snov.io API

Усі виклики Snov.io API працюють так – ви вводите URL-адресу, вхідні параметри та свій токен доступу, щоб отримати відповідь на конкретний запит:

Або ініціювати певну дію, наприклад:

Обмеження Snov.io API

У Snov.io API діють певні обмеження на кількість допустимих викликів на хвилину та годину.

Максимальна кількість запитів на хвилину становить 60.

Обмеження на годину залежать від вашого тарифного плану:

Ліміти на пошук email-адрес через API:

Ліміти на верифікацію email-адрес через API:

Ознайомтеся з усіма доступними викликами API, параметрами, вартістю в кредитах та лімітами у нашій документації API.

Не маєте власної програми, щоб підʼєднати до Snov.io через API, та все ж користуєтеся іншими корисними інструментами та хочете інтегрувати їх зі Snov.io? Дізнайтеся, як це зробити за допомогою Zapier.

Потрібен доступ до Snov.io API? Напишіть нашій команді підтримки та призначте онлайн-зустріч, щоб ознайомитися зі Snov.io API.

Exit mobile version