API клиент для Бизнес-платформа IEK https://bp.iek.ru/docs/client
Go to file
Pavel Sinitsin 05b8245f11
Refactor category variables and client authentication.
Renamed category variables to use underscores for better clarity and consistency. Updated client authentication method to accept username and password directly instead of using a Credentials struct.
2024-09-08 19:04:06 +03:00
api Refactor category variables and client authentication. 2024-09-08 19:04:06 +03:00
client Refactor category variables and client authentication. 2024-09-08 19:04:06 +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.