BTS API Docs

Token yangilash

POST /auth/refresh

Ushbu endpoint access token muddati tugaganda yoki tugash arafasida bo‘lganda yangi tokenlar olish uchun ishlatiladi.

So‘rovda foydalanuvchi o‘ziga tegishli `refresh_token` ni yuboradi. Agar refresh token yaroqli bo‘lsa,

server yangi `access_token` va `refresh_token` qaytaradi.

Yangi `access_token` 1 kun davomida amal qiladi va keyingi API so‘rovlarida

`Authorization: Bearer {token}` sarlavhasi orqali ishlatiladi.

`refresh_token` esa 30 kun davomida amal qiladi va access tokenni qayta-qayta yangilash imkonini beradi.

Agar refresh token noto‘g‘ri bo‘lsa, muddati tugagan bo‘lsa yoki server tomonidan bekor qilingan bo‘lsa,

so‘rov xatolik bilan yakunlanadi.

API Server


                    https://apitest.bts.uz:28345/

Base Path


                    /auth/refresh

Full URL


                        https://apitest.bts.uz:28345/auth/refresh

Authentication Bearer Token

Headers

Header

Value

Req.

Authorization

Bearer {token}

🔒

Content-Type

application/json

🔒

application/json

🔒

Request Body

                     
                     {
  "refresh_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9."
}

Field	Type	Description
`refresh_token`	string	Tokenni yangilash uchun refresh token

RESPONSE

200

Masalan: . Content-Type: application/json

Example
Schema

Response Body

                                 
                                 {
  "status": true,
  "message": "Token yangilandi.",
  "status_code": 200,
  "data": {
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.",
    "refresh_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9."
  }
}

Field	Type	Description
`status`	boolean	Amaliyot muvaffaqiyatli yoki yo‘q
`message`	string	Natija haqida xabar
`status_code`	integer	HTTP status kodi
`data`	object	Yangi tokenlar
`access_token`	string	Yangi access token 1 kun (24 soat) davomida amal qiladi.
`refresh_token`	string	Refresh token esa 30 kun davomida amal qiladi va access token muddati tugagandan so‘ng uni yangilash uchun ishlatiladi. Refresh token muddati tugagach, foydalanuvchi tizimga qayta login qilishi talab etiladi.

422

Masalan: . Content-Type: application/json

Example
Schema

Response Body

                                 
                                 {
  "status": false,
  "message": "Validation error.",
  "status_code": 422,
  "errors": {
    "password": [
      "Parol kamida 6 ta belgidan iborat bo‘lishi kerak"
    ]
  }
}

Field	Type	Description
	object	Ushbu xatolik refresh token noto‘g‘ri bo‘lsa, eskirgan bo‘lsa yoki server tomonidan bekor qilingan bo‘lsa qaytariladi.