An open API service indexing awesome lists of open source software.

https://github.com/vbondarevsky/1connector

Коннектор: удобный HTTP-клиент для oscript
https://github.com/vbondarevsky/1connector

aws4 cookies hacktoberfest hmac-sha256 http http-oscript httpconnection httprequest httpresponse json multipart-formdata oscript-lib post url x-www-form-urlencoded

Last synced: 8 days ago
JSON representation

Коннектор: удобный HTTP-клиент для oscript

Awesome Lists containing this project

README

          

# 1connector - удобный HTTP-клиент для oscript

[![Tests](https://github.com/vbondarevsky/1connector/actions/workflows/tests.yml/badge.svg?branch=master&event=push)](https://github.com/vbondarevsky/1connector/actions/workflows/tests.yml)
[![Quality Gate Status](https://sonar.openbsl.ru/api/project_badges/measure?project=1connector&metric=alert_status)](https://sonar.openbsl.ru/dashboard?id=1connector)
[![Coverage](https://sonar.openbsl.ru/api/project_badges/measure?project=1connector&metric=coverage)](https://sonar.openbsl.ru/dashboard?id=1connector)
[![Stars](https://img.shields.io/github/stars/vbondarevsky/1connector.svg?label=Github%20%E2%98%85&a)](https://github.com/vbondarevsky/1connector/stargazers)
[![Release](https://img.shields.io/github/tag/vbondarevsky/1connector.svg?label=Last%20release&a)](https://github.com/vbondarevsky/1connector/releases)
[![Чат по движку OneScript и библиотеке пакетов oscript-library](https://github.com/Patrolavia/telegram-badge/blob/master/chat.svg)](https://t.me/oscript_library)

Библиотека берет на себя всю рутину работы с HTTP запросами.
Буквально в одну строку можно получать данные, отправлять, не заботясь о необходимости конструирования URL, кодирования данных и т.п.
В общем библиотека очень мощная и проста в использовании.

## Пример работы
```bsl
Результат = КоннекторHTTP.Get("https://api.github.com/events").Json();
Результат = КоннекторHTTP.Get("https://api.github.com/events").Текст();
Результат = КоннекторHTTP.Get("https://api.github.com/events").ДвоичныеДанные();
```

## Возможности
Основные возможности библиотеки:
- Передача параметров в строку запроса (в URL)
- Удобная работа с запросами и ответами в формате `JSON`
- Отправка данных формы (полей формы), `application/x-www-form-urlencoded`
- Отправка данных формы (полей формы и файлов), `multipart/form-data`
- Прозрачная поддержка ответов, закодированных `GZip`
- `Basic`, `Digest` и `AWS4-HMAC-SHA256` аутентификация
- Автоматическое разрешение редиректов
- Установка и чтение Cookies
- Работа в рамках сессии с сохранением состояния (cookies, аутентификация и пр.)
- Переиспользование `HTTPСоединение`
- Настраиваемые повторные попытки соединения/отправки запроса с экспоненциальной задержкой
- И многое другое

## Требования
Платформа **1.2.0** и выше.

## Установка

Для установки необходимо:
* Скачать файл 1connector-*.ospx из раздела [releases](https://github.com/vbondarevsky/1connector/releases)
* Воспользоваться командой:

```
opm install -f <ПутьКФайлу>
```
или установить с хаба пакетов

```
opm install 1connector
```

## Публичный интерфейс

[Документация публичного интерфейса](https://github.com/vbondarevsky/1connector/blob/master/docs/README.md)

## Лицензия

Смотри файл [LICENSE](https://github.com/vbondarevsky/1connector/blob/develop/LICENSE).