squareup

// Интеграция с API Square с использованием управляемого OAuth. Обрабатывайте платежи, управляйте клиентами, заказами, каталогом, запасами и счетами. Используйте этот навык, когда необходимо принимать платежи, управлять POS-операциями, отслеживать инвентарь или работать с выставлением счетов через Square. Для других сторонних сервисов используйте навык api-gateway. Требуется доступ к сети и действительный API-ключ Maton. :

Square

Доступ к API Square с аутентификацией через управляемый OAuth. Позволяет обрабатывать платежи, управлять клиентами, заказами, элементами каталога, складскими остатками и счетами. :

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

# Список локаций
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/squareup/v2/locations')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Базовый URL

https://gateway.maton.ai/squareup/{native-api-path}

Замените {native-api-path} на фактический путь конечной точки Square API. Шлюз проксирует запросы к connect.squareup.com и автоматически подставляет OAuth-токен. :

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

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

Authorization: Bearer $MATON_API_KEY

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

export MATON_API_KEY="YOUR_API_KEY"

Как получить API-ключ

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

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

Управляйте OAuth-подключениями Square через панель управления:

https://ctrl.maton.ai

Пример: список подключений

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=squareup&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