Jobber

Интеграция с API Jobber с поддержкой управляемой OAuth-аутентификации. Позволяет работать с клиентами, задачами, счетами, сметами, объектами и участниками команды в сервисных компаниях.

Используйте этот инструмент, когда необходимо создавать и управлять заказами, клиентской базой, коммерческими предложениями, счетами или получать доступ к данным расписания. Для работы с другими сторонними сервисами рекомендуется использовать универсальный API-шлюз.

Обзор

Данный навык предоставляет доступ к API Jobber через централизованный шлюз с автоматическим управлением OAuth. Это позволяет упростить интеграцию и избежать ручной настройки авторизации.

С помощью него можно:

• управлять клиентами;
• создавать и отслеживать задания;
• формировать счета и предложения;
• работать с объектами и командами;
• получать данные о расписании.

Быстрый старт

Пример запроса для получения информации об аккаунте:

python <<'EOF'
import urllib.request, os, json
query = '{"query": "{ account { id name } }"}'
req = urllib.request.Request('https://gateway.maton.ai/jobber/graphql', data=query.encode(), method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Тип API

Jobber использует исключительно GraphQL API. Все запросы выполняются методом POST к endpoint /graphql с JSON-телом, содержащим поле query. :

Базовый URL

https://gateway.maton.ai/jobber/graphql

Шлюз автоматически проксирует запросы к официальному API Jobber и добавляет необходимые заголовки версии и авторизации.

Аутентификация

Все запросы требуют API-ключ Maton, который передается в заголовке:

Authorization: Bearer $MATON_API_KEY

Также автоматически добавляется заголовок версии GraphQL API.

Переменная окружения:

export MATON_API_KEY="YOUR_API_KEY"

Получение API-ключа

• Войдите или создайте аккаунт на maton.ai
• Перейдите в настройки
• Скопируйте ваш API-ключ

Управление подключениями

Управление OAuth-подключениями Jobber осуществляется через специальный интерфейс:

https://ctrl.maton.ai

Список подключений

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=jobber&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Создание подключения

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'jobber'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
EOF

Для корректной работы требуется доступ к сети и действительный API-ключ Maton.

---