Profile

This guide explains how to manage user profiles in the Calwe application.

Request

Show Profile

• Method: GET
• URL: /v1/customer/profile

Request Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes
Authorization	Bearer token	Yes

Success Response

GET /v1/customer/profile
{
 "success": true,
 "message": "تم جلب البيانات بنجاح.",
 "data": {
     "id": "cde55d16-d2ec-4429-9b08-cc5ad8e7fbdb",
     "firstName": "فاضل",
     "lastName": "الفاخوري",
     "email": "khalid@khalid.com",
     "birthDate": "2024/01/09",
     "phone": "966561497555",
     "phoneCode": "+966",
     "gender": "انثى",
     "avatar": "https://i.ibb.co/YhTw0wR/7-512.png",
     "country": {
         "id": "fc068332-c09a-43bf-aa11-04f6e8d623b1",
         "name": "السعودية",
         "phoneCode": "+966",
         "priority": null
     },
     "completeAccountPercentage": 100,
     "nationality": {
         "id": "f43fbf9b-03bd-4666-a689-68f84d10c665",
         "phoneCode": "+691",
         "name": "مايكرونيزيي"
     },
     "isEmailVerified": true,
     "sessionTimer": null,
     "sessionType": null,
     "canBookFreeSession": true
 },
 "statusCode": 200
}

Update Profile

• Method: POST
• URL: /v1/customer/profile

Request Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes
Authorization	Bearer token	Yes

Request Body

Parameter	Type	Description	Required
first_name	string	User's first name	No
last_name	string	User's last name	No
email	string	User's email address	No
old_password	string	User's old password	No
password	string	User's password	No
password_confirmation	string	User's password confirmation	No
phone	string	User's phone	No
gender	string	User's gender	No
birth_date	string	User's birth date	No
national_id	string	User's national	No
avatar	string	User's avatar	No
clear_avatar	string	User's clear avatar	No

Success Response

{
    "success": true,
    "message": "تم تحديث البيانات بنجاح.",
    "data": {
        "id": "uuid",
        "firstName": "فاضل",
        "lastName": "Saeed",
        "email": "khalid@khalid.com",
        "birthDate": "2024/01/09",
        "phone": "966561497555",
        "phoneCode": "+966",
        "gender": "انثى",
        "avatar": "https://i.ibb.co/YhTw0wR/7-512.png",
        "country": {
            "id": "uuid",
            "name": "السعودية",
            "phoneCode": "+966",
            "priority": null
        },
        "completeAccountPercentage": 100,
        "nationality": {
            "id": "uuid",
            "phoneCode": "+691",
            "name": "مايكرونيزيي"
        },
        "isEmailVerified": true,
        "sessionTimer": null,
        "sessionType": null,
        "canBookFreeSession": true
    },
    "statusCode": 200
}

Error Responses

Email Already Exists (422)

{
    "success": false,
    "message": "حدث خطأ في البيانات المرسلة يرجى التحقق منها.",
    "errors": {
        "email": "قيمة البريد الإلكتروني مُستخدمه من قبل."
    },
    "data": [],
    "statusCode": 422
}

Invalid Email Format (422)

{
    "success": false,
    "message": "حدث خطأ في البيانات المرسلة يرجى التحقق منها.",
    "errors": {
        "email": "صيغة البريد الإلكتروني غير صحيحة."
    },
    "data": [],
    "statusCode": 422
}

Send Verification Phone Code

• Method: POST
• URL: /v1/customer/profile/send-verification-phone-code

Request Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes
Authorization	Bearer token	Yes

Request Body

Parameter	Type	Description	Required
phone	string	User's phone	Yes

Success Response

{
    "success": true,
    "message": "تم ارسال رمز تفعيل الجوال مرة أخرى بنجاح.",
    "data": [],
    "statusCode": 200
}

Error Responses

Email Already Exists (422)

{
    "message": "قيمة رقم الهاتف مُستخدمه من قبل.",
    "errors": {
        "phone": [
            "قيمة رقم الهاتف مُستخدمه من قبل."
        ]
    }
}

Verify Phone

• Method: POST
• URL: /v1/customer/profile/verify-phone

Request Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes
Authorization	Bearer token	Yes

Request Body

Parameter	Type	Description	Required
phone	string	User's phone	Yes
phone_verified_code	string	User's verified phone code	Yes

Success Response

{
    "success": true,
    "message": "تم التحقق من رقم جوالك بنجاح",
    "data": [
        "777777777"
    ],
    "statusCode": 200
}

Error Responses

Email Already Exists (422)

{
    "success": false,
    "message": "كود التفعيل غير صحيح",
    "errors": [
        "كود التفعيل غير صحيح"
    ],
    "data": [],
    "statusCode": 422
}