Перейти к основному содержимому

Загрузки

Все SDK Shtab Connect скачиваются с этой страницы: серверные SDK интеграционного API и Kafka своего канала на Python, JS/TS и Go, Android SDK из Maven-репозитория портала и iOS SDK архивом xcframework. Пакеты той же версии, что документация «next»: версии и контрольные суммы ниже — у файлов, которые отдаёт портал сейчас.

В публичные реестры (PyPI, npm, Maven Central) SDK не публикуются. Их зависимости ставятся из публичных реестров или зеркала организации.

SDKВерсияФайлSHA-256
Python, API
shtab-helpdesk-api
1.0.0shtab_helpdesk_api-1.0.0-py3-none-any.whl
41 КБ
07230f74330c855b70551d47ad839f4ea61f570e595ead5adfd3b17c9ff40385
Python, Kafka
shtab-helpdesk-kafka
1.0.0shtab_helpdesk_kafka-1.0.0-py3-none-any.whl
20 КБ
ba23e300c0245e427c3e239f3ae665e985b394d6b0318ffe5bdf7729a867bccc
JS/TS, API
@shtab-helpdesk/api
1.0.0shtab-helpdesk-api-1.0.0.tgz
65 КБ
3a1dab2466845b4d232c50572649e67e93069aed7e1f147dd237854629012180
JS/TS, Kafka
@shtab-helpdesk/kafka
1.0.0shtab-helpdesk-kafka-1.0.0.tgz
27 КБ
6bd0df9b111da455d624467d4e4e12203f8b3397b8310ad0df06590da0dd4eb6
Go, API
developers.helpdesk.shtab.io/sdk/go/api
1.0.0shtab-helpdesk-api-go-1.0.0.tar.gz
45 КБ
f6290bf5adb9b56aa2e3f2cbe938e45fb3c8cc85b32f1b343e8fb0960304d861
Go, Kafka
developers.helpdesk.shtab.io/sdk/go/kafka
1.0.0shtab-helpdesk-kafka-go-1.0.0.tar.gz
21 КБ
1252b13b6bd53ea74e3e8d2d0845a316e74160cf1bc1a7762a44ec8d4548419a
Android
ru.shtab.helpdesk:helpdesk-android
1.0.0-beta.2helpdesk-android-1.0.0-beta.2.aar
990 КБ
86c7809458595b044883dca0c84740872e71dc8da39194265f2c330d43f5ff42
iOS
ShtabHelpdesk
1.0.0-beta.2бинарной сборки пока нет (см. iOS ниже)

Файл версии по своему адресу не меняется: новая версия SDK получает свой каталог /sdk/<версия>/, а в /sdk/latest/ лежат последние версии. Портал отдаёт все выпущенные версии: прежние — по своим адресам, в Maven-репозитории и через GOPROXY, как и текущая. Для воспроизводимой сборки ставьте пакет по адресу версии и храните скачанный файл у себя: в репозитории приложения или своём зеркале пакетов.

Проверка файлов​

  • /sdk/latest/SHA256SUMS — суммы файлов последних версий; у каждого каталога версии — свой SHA256SUMS.
  • /sdk/sdk.json — манифест: SDK, версии, пути, размеры и SHA-256 в JSON.
curl -fsSLO https://developers.helpdesk.shtab.io/sdk/latest/SHA256SUMS
sha256sum --check --ignore-missing SHA256SUMS

Python​

Python 3.11 и новее. Как подключить клиент, вызвать операцию и разобрать ошибку — в руководстве по SDK.

API-SDK
pip install https://developers.helpdesk.shtab.io/sdk/1.0.0/shtab_helpdesk_api-1.0.0-py3-none-any.whl
Kafka-SDK своего канала
pip install https://developers.helpdesk.shtab.io/sdk/1.0.0/shtab_helpdesk_kafka-1.0.0-py3-none-any.whl

JS/TS​

Node.js 22.22 и новее, ES-модули с типами TypeScript.

API-SDK
npm install https://developers.helpdesk.shtab.io/sdk/1.0.0/shtab-helpdesk-api-1.0.0.tgz
Kafka-SDK своего канала
npm install https://developers.helpdesk.shtab.io/sdk/1.0.0/shtab-helpdesk-kafka-1.0.0.tgz

Go​

Go 1.26 и новее. Путь модуля — адрес на портале, go get находит его сам. Обычные настройки Go подходят. Если сеть сборки закрыта для proxy.golang.org и sum.golang.org, задайте GOPRIVATE с доменом портала, подробно — в руководстве по SDK.

API-SDK
go get developers.helpdesk.shtab.io/sdk/go/api@v1.0.0
Kafka-SDK своего канала
go get developers.helpdesk.shtab.io/sdk/go/kafka@v1.0.0

Сборка без доступа к порталу — архив исходников рядом с вашим модулем и replace:

API-SDK
curl -fsSLO https://developers.helpdesk.shtab.io/sdk/1.0.0/shtab-helpdesk-api-go-1.0.0.tar.gz
mkdir -p third_party && tar -xzf shtab-helpdesk-api-go-1.0.0.tar.gz -C third_party
go mod edit -require=developers.helpdesk.shtab.io/sdk/go/api@v1.0.0 \
-replace=developers.helpdesk.shtab.io/sdk/go/api=./third_party/api
go mod tidy
Kafka-SDK своего канала
curl -fsSLO https://developers.helpdesk.shtab.io/sdk/1.0.0/shtab-helpdesk-kafka-go-1.0.0.tar.gz
mkdir -p third_party && tar -xzf shtab-helpdesk-kafka-go-1.0.0.tar.gz -C third_party
go mod edit -require=developers.helpdesk.shtab.io/sdk/go/kafka@v1.0.0 \
-replace=developers.helpdesk.shtab.io/sdk/go/kafka=./third_party/kafka
go mod tidy

Android​

Android 8.0 (API 26) и новее. Maven-репозиторий портала отдаёт AAR, POM и метаданные Gradle с контрольными суммами. Фильтр includeGroup ищет в нём только пакеты Shtab. Подробно — руководство Android.

// settings.gradle.kts
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://developers.helpdesk.shtab.io/maven")
content { includeGroup("ru.shtab.helpdesk") }
}
}
}

// app/build.gradle.kts
dependencies {
implementation("ru.shtab.helpdesk:helpdesk-android:1.0.0-beta.2")
}

Файлы версии 1.0.0-beta.2: helpdesk-android-1.0.0-beta.2.aar, helpdesk-android-1.0.0-beta.2.pom. Свой Maven или каталог в репозитории приложения — копия этого репозитория.

iOS​

iOS 15.4 и новее, Swift Package Manager. Подробно — руководство iOS.

к сведению
Бинарной сборки iOS SDK на портале пока нет: xcframework выкладывается к выпуску SDK. Когда она появится, здесь будут архив ShtabHelpdesk-<версия>.xcframework.zip, его контрольная сумма и готовый .binaryTarget.

Без доступа к порталу​

Для сборки без интернета те же пакеты есть в комплекте поставки установки: серверные SDK — в sdk/, Android — Maven-каталогом mobile/android/maven/. Версия пакетов комплекта совпадает с версией установки, комплект выдаёт администратор установки.