Kitworks API/Custom API controller
Для того щоб налаштувати даний модуль в Odoo слід вибрати категорію Додатки, натиснути кнопку «Оновити списки додатків» (що знаходиться зліва в верхньому рядку) та в пошуковій стрічці ввести "API", знайдені модулі встановити. Даний модуль складається з модуля Custom API controller та модуля Kitworks API.
Наступним кроком буде зайти в Загальні налаштування та активувати режим розробника. В верхній панелі з'являється підменю АРІ.
Для того щоб створити новий Endpoint вибираємо Custom Endpoint/ Новий.
При натисканні на «Додати рядок» на вкладці Fields (поля) Вам відкривається нове діалогове вікно з можливістю вибрати ті дані, які Ви хочете отримати з вибраної Вами Моделі. В даному вікні Ви маєте можливість вибрати Пошук, натиснувши на маленьку емблему трикутника, що знаходиться в кінці поля для введення даних. Ви можете додавати стільки полів, скільки Вам необхідно.
Для уточнення полів (виведення назви, тегів) слід використовувати Data Endpoint.
При збереженні Custom Endpoint модуль автоматично надає Вам АРІ адресу.
Для того, щоб згенерувати токен чи ключ Вам необхідно зайти в АРІ/API token чи API keys та натиснути "Новий". Для API token заповніть поле Користувач та натисніть Зберегти, а для API keys внесіть Name та Code в довільному форматі, та також натисніть Зберегти. При створенні ключів також можна вказати дозволені ІР адреси, з яких можна робити запити.
Всі відправлені запити записуються в підменю API - LOGs для зручності відслідковування, пошуку та деталізації всіх відправлених запитів.
В Налаштуваннях АРІ Ви можете самостійно вказати префікс token, тривалість дії token та інші налаштування.
Зверніть увагу, що токен має дату закінчення і якщо термін вичерпано, треба оновити дату.
Для прикладу, відправляємо один отриманий Endpoint через Postman.
Для цього реєструємось на сайті https://identity.getpostman.com/signup
Заходимо під створеним логіном і паролем https://identity.getpostman.com/login
І створюємо свій робочій простір.
Обираємо API testing
Пишемо назву
Створюєте нову колекцію
Додати запит.
Копіюємо Endpoint і Token з Odoo і вставляємо в Postman. Натискаємо кнопку Send.
На скріні метод GET який відповідає за отримання даних з сервера.
Якщо треба створити нові дані на сервері треба використовувати метод POST.
В параметрах ендпоінта необхідно ввімкнути галочку на створення.
Копіюємо Endpoint і Token, або ключ з Odoo і вставляємо в Postman. Додаємо в Body обов'язкові поля для створення в заложності від моделі. Натискаємо кнопку Send.
Для оновлення даних, треба в параметрах ендпоінта ввімкнути галочку оновлення.
Копіюємо Endpoint і Token, або ключ з Odoo і вставляємо в Postman. Додаємо в ендоінт через слеш id товара який треба оновити. Обираємо метод Post. В Body додаємо поля які необхідно оновити. Натискаємо кнопку Send.
Для видалення даних з сервера, треба додати галочку в параметрах ендпоінта.
Копіюємо Endpoint і Token, або ключ з Odoo і вставляємо в Postman. Додаємо в ендоінт через слеш id товара який треба видалити. Обираємо метод Delete. Натискаємо кнопку Send.
Для того, щоб налаштовувати PowerBi на роботу з нашими ендпоінтами, необхідно зробити наступне.
Зверніть увагу, що модуль не працює, якщо на одному url декілька баз.