Papkov ID
Работа с OAuth2
Регистрация аккаунта разработчика
Заполните форму на странице регистрации аккаунта разработчика, подтвердите свои данные и получите статус разработчика 1 уровня
Интеграция Papkov Auth
Используйте наш REST API для авторизации. Документация включает примеры на PHP, JavaScript, Papkov Crossplatform Script и других языках
После регистрации аккаунта разработчика, из Papkov ID вы можете получить личный приватный API ключ
Откройте панель разработчика и найдите в информации ваш Secret Key
Потом нажмите на "Создать ключ", и в открытом окне введите название компании, какие данные она будет обрабатывать, и прочее...
После получения приватного ключа, вы можете использовать его в OAuth 2.0 для авторизации https://id.vovapapkov.ru/api.php?action=generate
{
"auth_key": "здесь_ключ_авторизации",
"secret_key": "здесь_ваш_секретный_ключ"
}
{
"status": "success",
"redirect": "https://id.vovapapkov.ru/api.php?login=ВРЕМЕННЫЙ_АЙДИ_АВТОРИЗАЦИИ",
"id": "ВРЕМЕННЫЙ_АЙДИ_АВТОРИЗАЦИИ"
}
Для проверки статуса авторизации, нужно использовать long polling запрос на https://id.vovapapkov.ru/api.php?action=checkauth
{
"temp_key": "ВРЕМЕННЫЙ_АЙДИ_АВТОРИЗАЦИИ",
"secret_key": "здесь_ваш_секретный_ключ"
}
При автосбросе лонг пуллинга (будет сбрасываться каждую минуту), ответ будет такой:
{
"status": "waiting",
"userid": null
}
При успешной авторизации, ответ будет такой:
{
"status": "success",
"forever_key": "ВЕЧНЫЙ_КЛЮЧ_ПОЛЬЗОВАТЕЛЯ",
"userid": айди_авторизованного_пользователя
}
ВАЖНО! Вечный ключ пользователя используется для получения его доступных данных через API
Также, можно в ссылке на переадресацию вписать {id} плейсхолдер - ссылка сама заменит его на временный айди авторизации
Единый эндпоинт для получения данных: https://id.vovapapkov.ru/api.php?action=check
Чтобы получить данные пользователя, используйте тело запроса
{
"forever_key": "ПОЛУЧЕННЫЙ_ВЕЧНЫЙ_КЛЮЧ_ПОЛЬЗОВАТЕЛЯ",
"secret_key": "здесь_ваш_секретный_ключ",
"get": "тип_данных" // userinfo/balance/mail/number/telegram
}
При ошибке вечного ключа ответ будет:
{
"status": "error",
"message": "Неверный вечный ключ"
}
При успехе, ответы будут такие:
{
"status": "success",
"id": айди_пользователя,
"username": "имя_пользователя"
}
{
"status": "success",
"balance": баланс_пользователя
}
{
"status": "success",
"mail": "почта_пользователя"
}
{
"status": "success",
"number": "номер_телефона_пользователя"
}
{
"status": "success",
"telegramid": "айди_телеграм_аккаунта"
}