API клиент для Бизнес-платформа IEK https://bp.iek.ru/docs/client
Go to file
Pavel Sinitsin c0290e776c
Remove unnecessary import block formatting
Consolidate the import statement to a single line for readability. This change reduces code clutter and adheres to cleaner code standards.
2024-09-09 18:14:37 +03:00
api Refactor category variables and client authentication. 2024-09-08 19:04:06 +03:00
client Remove unnecessary import block formatting 2024-09-09 18:14:37 +03:00
model Refactor credential handling and improve parsing logic 2024-09-08 13:50:05 +03:00
utils Add tree structure to categories API 2024-09-07 21:18:36 +03:00
.gitignore Add new API and client modules for category and product management 2024-09-07 19:14:29 +03:00
go.mod Add new API and client modules for category and product management 2024-09-07 19:14:29 +03:00
go.sum Add new API and client modules for category and product management 2024-09-07 19:14:29 +03:00
LICENSE.md Add README and LICENSE files 2024-09-08 14:25:11 +03:00
README.md Add README and LICENSE files 2024-09-08 14:25:11 +03:00

API клиент бизнес-платформы IEK

Содержание

Начало работы

Эти инструкции помогут вам запустить копию проекта на вашем локальном компьютере для целей разработки и тестирования.

Установка Go

Убедитесь, что у вас установлена последняя версия Go. Инструкции по установке можно найти на официальном сайте Go.

Пример:

go version go1.23.1

Установка

Пошаговая инструкция по созданию окружения.

  1. Установите проект с помощью go get
    go get -u gitea.24example.ru/spavelit/bpiek
    
  2. Установите зависимости
    go mod tidy
    

Использование

Инструкции по использованию вашего проекта.

Запуск приложения

Пример:

go run main.go

Пример использования

Примечание: Добавьте пример кода, чтобы пользователи могли быстро начать работу с вашим проектом.

package main

import (
	"encoding/json"
	"fmt"
	bpiek "gitea.24example.ru/spavelit/bpiek/api"
)

func main() {
	credentials := bpiek.Credentials{
		Username: "mail@example.ru",
		Password: "password",
	}

	api := bpiek.NewApi(credentials)
	
	result, err := api.GetRemainsAndPlanresidues()
	if err != nil {
		panic(err)
	}

	b, _ := json.MarshalIndent(result[1], "", "  ")
	fmt.Print(string(b))
}

Доступные методы

В данном разделе приведены основные методы, доступные в API клиенте для бизнес-платформы IEK:

  1. NewApi(credentials bpiek.Credentials)

    • Создает новый экземпляр API клиента с предоставленными учетными данными.
  2. GetParentCategories() ([]model.Category, error)

    • Возвращает массив категорий каталога 1-ого уровня.
  3. GetCategories() ([]model.Category, error)

    • Возвращает массив с категориями.
  4. GetTreeCategories() ([]model.TreeCategories, error)

    • Возвращает дерево категорий.
  5. GetProducts() ([]model.Product, error)

    • Возвращает массив с продукцией.
  6. GetProductByArticle(article string) (model.Product, error)

    • Возвращает товар по артикулу.
  7. GetRemainsAndPlanresidues() ([]model.ShortProduct, error)

    • Возвращает массив, в котором содержатся актуальные цены и остатки товаров.

Эти методы могут использоваться для взаимодействия с бизнес-платформой IEK в рамках вашего проекта. Подробная документация каждого метода доступна в исходниках или официальной документации БП IEK.

Используемые инструменты

Список инструментов и библиотек, которые использовались при создании проекта.

  • GoLang - Язык программирования.
  • Resty - Simple HTTP and REST client library for Go.

Авторы

  • Павел Синицин - Rosar-L - Gitea

Лицензия

Этот проект лицензирован под лицензией MIT - подробности смотрите в файле LICENSE.md.