API
API
API
API
API
API
API

BSG використовує HTTP-cookies (а також подібні або додаткові технології), щоб:
1) забезпечити безпечну, стабільну та доступну роботу сайту (через використання обов’язкових cookies) та
2) зрозуміти, як ви користуєтеся сайтом (через використання необов’язкових cookies) — з метою покращення вашого досвіду та надання персоналізованого контенту.

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

Відповідно до вимог Загального регламенту про захист даних (GDPR), який регулює обробку та передачу персональних даних осіб у ЄС, ми надаємо вам можливість заборонити використання певних типів cookies під час відвідування нашого сайту.

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

Прийняти всі cookies*
*Рекомендовано для комфортного користування сайтом
Прийняти лише необхідні cookies
Прийняти лише вибрані cookies
Необхідні cookies
Соціальні мережі
Аналітика
Маркетинг

BSG переїхав на новий DevPortal
щоб швидше випускати найновіші версії One API

Використовуйте його для актуальних ендпоінтів, гайдів і журналів змін

Перейти на новий DevPortal
Документація для розробників
Number Intelligence

Пошук у списку контактів

Метод для пошуку в списку контактів за допомогою операцій like, =, >, >=, <, <=. Пошук можливий за такими полями:

  • name
  • description
  • date
  • items
  • phone
  • id

Щоб виконати пошук у списку контактів, надішліть запит на цей сервер:

GET https://one-api.bsg.world/api/groups/search

Request parameters:

Parameter Required Type Default Description
page[offset] No integer 0 Отримати групи контактів, починаючи зі зсуву (offset)
page[limit] No integer 50 Кількість груп контактів у відповіді
sort No string id Умови сортування: id, items, name, description, date
way No string asc Варіанти сортування: asc, desc
search[operator] No string = Оператор для пошуку значень: like, =, >, >=, <, <=
search[field] No string no Поля для пошуку: name, items, date, description, phone, id
search[value] Значення для пошуку: No string no
name Назва списку. До 50 символів
description Опис списку. До 250 символів
date Дата створення списку у форматі ISO 8601: yyyy-mm-dd hh:mm:ss
items Кількість контактів у списку
phone Номер телефону, який список містить/не містить. 9–15 цифр
id Ідентифікатор списку контактів

Response parameters:

Parameter Type Description
id integer List ID
name string List name
description string List description
is_default boolean Чи є список списком за замовчуванням. Можливі значення: true, false
items integer Кількість контактів у списку
created at string Дата й час створення списку. Формат ISO 8601 yyyy-mm-dd hh:mm:ss

Якщо запит виконано успішно, ви отримаєте відповідь:


{
  "data": [
    {
      "id": 1,
      "name": "string",
      "description": "string",
      "is_default": true,
      "items": 0,
      "created_at": "2022-04-28 14:21:16"
    }
  ],
  "meta": {
    "page": {
      "total": 1,
      "offset": 20,
      "limit": 40
    },
    "search": {
      "field": "id",
      "operator": "like",
      "value": "string"
    }
  }
}

Зацікавлені у спеціальній пропозиції?

Готові розширювати можливості?
Давайте обговоримо.

Надіслати

Корисні Матеріали

WhatsApp Business API: повний гайд — налаштування, ціни, сценарії [2026]
WhatsApp Business API: повний гайд — налаштування, ціни, сценарії використання [2026]

WhatsApp Business API у 2026 — кроки налаштування, нова модель тарифікації за повідомлення та перевірені сценарії використання за галузями.

Що таке CPaaS? Повний бізнес-гайд із Communications Platform as a Service
Що таке CPaaS? Повний бізнес-гайд із Communications Platform as a Service

Що таке CPaaS? Хмарний API-шар, що додає SMS, WhatsApp, голос та OTP у ваші застосунки — як це працює і чому це краще за стек із кількох вендорів.

Один комунікаційний API для SMS, WhatsApp, Viber і RCS — чому він кращий за пʼять
Один комунікаційний API для SMS, WhatsApp, Viber та RCS — чому він кращий за пʼять

Чому один комунікаційний API для SMS, WhatsApp, Viber та RCS кращий за пʼять окремих інтеграцій — каскадний fallback, єдині звіти.