authing-py-sdk

Поддержка Authing Python SDK в настоящее время ограничивается Python 3+.

Официальная документация доступна здесь.

Установка

pip

При создании крупномасштабных приложений мы рекомендуем использовать pip для установки, так как это хорошо сочетается с некоторыми модулями пакетных инструментов. Обратите внимание, что Authing в настоящее время может быть установлен только через pip3 и выше.

# последняя стабильная версия
$ pip install authing

Начало работы

Сначала создайте файл с именем pub.pem в текущей директории и скопируйте следующий текст в этот файл:

-----BEGIN PUBLIC KEY-----
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC4xKeUgQ+Aoz7TLfAfs9+paePb
5KIofVthEopwrXFkp8OCeocaTHt9ICjTT2QeJh6cZaDaArfZ873GPUn00eOIZ7Ae
+TiA2BKHbCvloW3w5Lnqm70iSsUi5Fmu9/2+68GZRH9L7Mlh8cFksCicW2Y2W2uM
GKl64GDcIq3au+aqJQIDAQAB
-----END PUBLIC KEY-----

Затем выполните инициализацию Authing:

from authing.authing import Authing

client_id = 'ваш_client_id'
secret = 'ваш_app_secret'

authing = Authing(client_id, secret)

# Если Authing не удается проверить client_id и secret, будет выброшено исключение. Поэтому можно использовать try...except для гарантии того, что программа не завершится ошибкой.

user = authing.login(**{
    'email': 'test@testmail.com',
    'password': 'testpassword'
})

if user.get('errors'):
    # Ошибка
else:
    # Без ошибок

Как получить Client ID и Secret?.

Обработка ошибок

----------Если данные, возвращаемые API SDK, содержат ошибки, они будут храниться в поле "errors". Таким образом, вы можете использовать следующий код для проверки наличия ошибок:

if 'errors' in response and response['errors']:
    # Обработка ошибок

В этом примере response — это объект, который содержит ответ от API. Если поле "errors" существует и не пусто, значит, в данных присутствуют ошибки.```python

result = authing.xxx() # Выполнение метода authing

if result.get('errors'): # Ошибка, например, """ {'code': 500, 'message': 'Преобразование в ObjectId не удалось для значения "5aec1ea610ecb800018db176xx" по пути "_id" для модели "User"', 'data': None, 'errors': True} """ else: # Без ошибок, используйте данные напрямую, например, """ {'_id': '5aec1ea610ecb800018db176', 'email': 'xieyang@dodora.cn', 'is_deleted': False} """

## Настройка пользовательских URL-адресов запросов

----------

Если вы выполнили частное развертывание Authing, вы можете инициализировать URL-адрес следующим образом:

```python
from authing.authing import Authing

client_id = 'ваш_client_id'
secret = 'ваш_app_secret'

authing = Authing(client_id, secret, {
    "oauth": 'https://oauth.your_url.com/graphql',
    "users": 'https://users.your_url.com/graphql'
})

Для получения более подробной информации об ошибках, обратитесь к списку кодов ошибок.

Документация по API доступна здесь.