Загрузки
Все 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, APIshtab-helpdesk-api | 1.0.0 | shtab_helpdesk_api-1.0.0-py3-none-any.whl 41 КБ | 07230f74330c855b70551d47ad839f4ea61f570e595ead5adfd3b17c9ff40385 |
Python, Kafkashtab-helpdesk-kafka | 1.0.0 | shtab_helpdesk_kafka-1.0.0-py3-none-any.whl 20 КБ | ba23e300c0245e427c3e239f3ae665e985b394d6b0318ffe5bdf7729a867bccc |
JS/TS, API@shtab-helpdesk/api | 1.0.0 | shtab-helpdesk-api-1.0.0.tgz 65 КБ | 3a1dab2466845b4d232c50572649e67e93069aed7e1f147dd237854629012180 |
JS/TS, Kafka@shtab-helpdesk/kafka | 1.0.0 | shtab-helpdesk-kafka-1.0.0.tgz 27 КБ | 6bd0df9b111da455d624467d4e4e12203f8b3397b8310ad0df06590da0dd4eb6 |
Go, APIdevelopers.helpdesk.shtab.io/sdk/go/api | 1.0.0 | shtab-helpdesk-api-go-1.0.0.tar.gz 45 КБ | f6290bf5adb9b56aa2e3f2cbe938e45fb3c8cc85b32f1b343e8fb0960304d861 |
Go, Kafkadevelopers.helpdesk.shtab.io/sdk/go/kafka | 1.0.0 | shtab-helpdesk-kafka-go-1.0.0.tar.gz 21 КБ | 1252b13b6bd53ea74e3e8d2d0845a316e74160cf1bc1a7762a44ec8d4548419a |
Androidru.shtab.helpdesk:helpdesk-android | 1.0.0-beta.2 | helpdesk-android-1.0.0-beta.2.aar 990 КБ | 86c7809458595b044883dca0c84740872e71dc8da39194265f2c330d43f5ff42 |
iOSShtabHelpdesk | 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.
pip install https://developers.helpdesk.shtab.io/sdk/1.0.0/shtab_helpdesk_api-1.0.0-py3-none-any.whl
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.
npm install https://developers.helpdesk.shtab.io/sdk/1.0.0/shtab-helpdesk-api-1.0.0.tgz
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.
go get developers.helpdesk.shtab.io/sdk/go/api@v1.0.0
go get developers.helpdesk.shtab.io/sdk/go/kafka@v1.0.0
Сборка без доступа к порталу — архив исходников рядом с вашим модулем и replace:
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
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.
ShtabHelpdesk-<версия>.xcframework.zip, его контрольная сумма и готовый .binaryTarget.Без доступа к порталу
Для сборки без интернета те же пакеты есть в комплекте поставки установки: серверные SDK — в sdk/, Android — Maven-каталогом mobile/android/maven/. Версия пакетов комплекта совпадает с версией установки, комплект выдаёт администратор установки.