POST /auth/exchange

Exchange code for user profile information.

application/json

Body Required

  • code string

    The authorization code received from Google OAuth2

  • redirectUri string

    The redirect URI used in the OAuth2 flow

Responses

  • 200 application/json

    Get link to Google OAuth2 authorization URL

    Hide response attributes Show response attributes object
    • success boolean
    • code integer(int32)
    • message string
    • data object
      Hide data attributes Show data attributes object
      • id string

        Unique identifier for the user

      • email string(email)

        User's email address

      • firstName string

        User's first name

      • lastName string

        User's last name

      • dateOfBirth string(date)

        User's date of birth

      • avatarUrl string | null

        URL of the user's profile avatar

      • createdAt string(date-time)

        Timestamp when the user profile was created

      • updatedAt string(date-time)

        Timestamp when the user profile was last updated

      • phoneNumber string | null

        User's phone number (optional)

  • 400 application/json

    Bad Request - Invalid input data

    Hide response attributes Show response attributes object
    • success boolean
    • code integer
    • errorCode string
    • message string
    • timestamp string(date-time)
  • 500 application/json

    Internal Server Error

    Hide response attributes Show response attributes object
    • success boolean
    • code integer
    • errorCode string
    • message string
    • timestamp string(date-time)
POST /auth/exchange
curl \
 --request POST 'https://api.huy-devops.site/api/auth/exchange' \
 --header "Content-Type: application/json" \
 --data '{"code":"4/0AY0e-g7...","redirectUri":"http://localhost:3000"}'
Request examples
{
  "code": "4/0AY0e-g7...",
  "redirectUri": "http://localhost:3000"
}
Response examples (200)
{
  "success": true,
  "code": 200,
  "message": "string",
  "data": {
    "id": "user_12345",
    "email": "user@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "dateOfBirth": "1990-01-01",
    "avatarUrl": "https://cdn.example.com/avatars/user_12345.jpg",
    "createdAt": "2025-08-30T10:30:00Z",
    "updatedAt": "2025-08-30T15:45:00Z",
    "phoneNumber": "+1234567890"
  }
}
Response examples (400)
{
  "success": false,
  "code": 42,
  "errorCode": "string",
  "message": "string",
  "timestamp": "2025-05-04T09:42:00Z"
}
Response examples (500)
{
  "success": false,
  "code": 42,
  "errorCode": "string",
  "message": "string",
  "timestamp": "2025-05-04T09:42:00Z"
}