API для свого сайту

Вартість

120 грн/міс

Для кого

сфера послуг, заклади харчування, магазини

Потрібні модулі

Товари, Замовлення

Що дає інтеграція

Свій сайт чи застосунок, написаний під себе, сам надсилає в anyCRM товари, замовлення й клієнтів через REST API — додає нові та оновлює наявні.

Що знадобиться

• Розробник, який додасть на сайт кілька HTTP-запитів.

Де взяти ключі

1. В anyCRM на сторінці модуля «API для свого сайту» натисніть «Підключити».
2. Скопіюйте токен (acapi_…) і натисніть «Зберегти». Токен показується лише раз — збережіть його в налаштуваннях сайту.
3. Надсилайте запити, як описано нижче.

API

Адреса: https://api.anycrm.io/api/v1/. Усі запити — POST з JSON і заголовком Authorization: Bearer acapi_…. Тіло — один об’єкт, список або {"products": [...]} (orders, customers), до 500 записів.

POST /api/v1/products

Товар упізнається за вашим id, а новий — ще й за SKU серед наявних. Товар із variants стає карткою, варіанти — окремими товарами. quantity встановлює залишок в anyCRM. Обов’язкові: id, title; у варіанта — id. Якщо в anyCRM уже є товари, додані не з цього API, нові не створюються самі: вони чекають у «Незв’язаних» ("linked": false), доки ви не зв’яжете їх чи не ввімкнете «Створювати нові товари» в ⚙.

curl https://api.anycrm.io/api/v1/products \
  -H "Authorization: Bearer acapi_..." -H "Content-Type: application/json" \
  -d '{"products": [{
    "id": "15", "title": "T-shirt", "sku": "TS", "price": 450, "currency": "uah",
    "category": "Clothes", "description": "...", "images": ["https://.../1.jpg"],
    "url": "https://shop.example/ts", "available": true,
    "params": {"Material": "Cotton"},
    "variants": [
      {"id": "m", "title": "M", "sku": "TS-M", "quantity": 3},
      {"id": "l", "title": "L", "sku": "TS-L", "price": 480, "quantity": 0}
    ]
  }]}'

{"ok": true, "products": [{"id": "15", "product_id": 301, "linked": true}, {"id": "15-m", "product_id": 302, "linked": true}]}

POST /api/v1/orders

Нове замовлення створюється разом із клієнтом (за телефоном) і списує товари. Повторне надсилання з тим самим id оновлює статус і ТТН; завершене чи скасоване в anyCRM не змінюється. Статуси: new, processing, shipped, completed, canceled. Рядок з product_id (і variant_id) зв’язується з товаром, надісланим раніше; без нього — просто рядок з назвою й ціною.

{
  "id": "A-1042", "status": "new", "date": "2026-09-30T12:00:00Z", "currency": "uah",
  "customer": {"first_name": "Olena", "last_name": "Koval", "phone": "+380671234567", "email": "o@example.com"},
  "items": [
    {"product_id": "15", "variant_id": "m", "title": "T-shirt M", "qty": 2, "price": 450},
    {"title": "Gift wrap", "qty": 1, "price": 30}
  ],
  "shipping": "Nova Poshta", "shipping_cost": 80, "city": "Kyiv", "address": "Branch 12",
  "ttn": "", "payment_method": "card", "paid": true, "comment": "Call first"
}

{"ok": true, "orders": [{"id": "A-1042", "order_id": 518, "created": true, "status": "newOrder"}]}

POST /api/v1/customers

Клієнт упізнається за телефоном, потім за email; потрібне хоча б одне з них. Передані поля оновлюються, решта лишається.

{"first_name": "Olena", "last_name": "Koval", "middle_name": "", "company_name": "", "phone": "+380671234567", "email": "o@example.com", "notes": "VIP"}

Помилки

Відповідь з помилкою — {"ok": false, "error": "..."} і код: 400 — не JSON, 401 — невірний токен, 403 — модуль вимкнено, 413 — понад 500 записів, 422 — бракує поля чи невірне значення (ціна чи кількість не число). Запит можна безпечно повторити.

Підключення в anyCRM

1. Відкрийте Модулі в anyCRM, знайдіть «API для свого сайту» і натисніть «Підключити».
2. Перейдіть на сторінку модуля в бічній панелі та натисніть «Підключити».
3. Акаунт з’явиться у списку із зеленою позначкою. Помилка, якщо є, показується під його назвою червоним.

Корисно знати

• Токен — це доступ до ваших даних. Загубили чи він потрапив не туди — видаліть підключення й створіть нове: старий токен одразу перестане працювати.
• API лише додає й оновлює: читати й видаляти через нього не можна.