Перейти к содержимому

Вход и токены

Адрес API: https://api.vpulse.fun. Запросы и ответы в JSON. Вход по номеру телефона, тот же, что в приложении.

Окно терминала
curl -X POST https://api.vpulse.fun/auth/request-code \
-H "Content-Type: application/json" \
-d '{"phone": "+79991234567"}'

На номер придёт код. Отправьте его вместе с номером:

Окно терминала
curl -X POST https://api.vpulse.fun/auth/verify \
-H "Content-Type: application/json" \
-d '{"phone": "+79991234567", "code": "12345", "device": "my-script"}'

В ответе два токена и профиль:

{
"accessToken": "eyJ...",
"refreshToken": "c3f1...",
"isNew": false,
"user": { "id": "...", "pulseId": "...", "displayName": "..." }
}

device - подпись входа, её видно в списке устройств в настройках приложения. Аккаунт удобнее сначала завести в приложении: там вы примете условия и заполните профиль.

accessToken передаётся в каждом запросе заголовком:

Authorization: Bearer eyJ...

Он живёт 15 минут. Когда истечёт, сервер ответит 401, и нужно получить новую пару по refreshToken:

Окно терминала
curl -X POST https://api.vpulse.fun/auth/refresh \
-H "Content-Type: application/json" \
-d '{"refreshToken": "c3f1..."}'

Старый refreshToken после этого не работает, сохраните новый. Завершить вход: POST /auth/logout с тем же телом.

Не выкладывайте токены в открытые репозитории: с ними можно читать и писать сообщения от вашего имени.