HttpFaceTimeCloneAPI

FaceTime API That's Built With Ktor to create calling rooms.. This repository contains a FaceTime API This is an educational API.Use and run this API to learn more about API design and best practices you must follow.That's built with Ktor , That's implements Coroutines,JWT,Clean Architecture,Koin,mongodb,jackson,etc... using kotlin language with ktor framework.
You can find postman documentation here -> Postman Documentation
You can find this API in postman here -> Postman Collection

Table Of Content

Endpoints
- User endpoint
  - Introduction
  - Operatores
- Rooms endpoint
  - Introduction
  - Operatores
Built With
Project Structure
License

Endpoints

User endpoint

Introduction

In this part you will find user operators you can make such as

Login With Email And Password
Register With Email And Password
Edit Your Profile
View Your Profile
Send Verification Code To Email
Verify Code sent To Email
Delete Your Account

Operators

POST Login

 http://127.0.0.1:8080/user/login

Body raw (json)

{
  "email": "adelayman0000@gmail.com",
  "password": "123456"
}

Response

{
    "status": true,
    "data": {
        "userID": "63d5b2c8db392954ecae9737",
        "userToken": "TOKEN",
        "userName": "Adel Ayman",
        "email": "adelayman0000@gmail.com",
        "isVerified": true,
        "fcmToken": "YOUR_FCM_TOKEN"
    },
    "message": "Login done successfully"
}

POST Register

 http://127.0.0.1:8080/user/register

Body raw (json)

{
  "name": "Adel Ayman",
  "email": "adelayman0000@gmail.com",
  "password": "123456"
}

Response

{
    "status": true,
    "data": {
        "userID": "63d8537bf7f5302cce37e4a7",
        "userToken": "TOKEN",
        "userName": "Adel Ayman",
        "email": "test@gmail.com",
        "isVerified": false,
        "fcmToken": "Guest"
    },
    "message": "Registration done successfully"
}

Fcm Token

This part contains FCM Operators for example

Edit FCM Token
Get User FCM Token By Email

PATCH Edit FCM Token

In this request you can edit you FCM token. we use your FCM token to send call invitation to you

Important Note:you must active your account first. you can active account by verify it

http://127.0.0.1:8080/user/fcm-token

Request Headers

Authorization:Bearer TOKEN

Body raw (json)

{
    "fcmToken":"YOUR_FCM_TOKEN"
}

Response

{
    "status": true,
    "data": {
        "userID": "63d5b2c8db392954ecae9737",
        "userToken": null,
        "userName": "Adel Ayman",
        "email": "adelayman0000@gmail.com",
        "isVerified": false,
        "fcmToken": "YOUR_FCM_TOKEN"
    },
    "message": "user details updated successfully"
}

Fcm Token

This part contains FCM Operators for example

Edit FCM Token
Get User FCM Token By Email

GET Get FCM Token

In this request you can get your fcm

Important Note:you must active your account first. you can active account by verify it

http://127.0.0.1:8080/user/fcm-token

Request Headers

Authorization:Bearer TOKEN

Response

{
    "status": true,
    "data": "YOUR_FCM_TOKEN",
    "message": "token has got successfully"
}

PATCH Edit Profile

In this request you can change your account information like name Important Note:you must active your account first. you can active account by verify it

 http://127.0.0.1:8080/user

Request Headers

Authorization:Bearer TOKEN

Body raw (json)

{
    "name":"Adel Ayman"
}

Response

{
    "status": true,
    "data": {
        "userID": "63d5b2c8db392954ecae9737",
        "userToken": null,
        "userName": "Adel Ayman",
        "email": "adelayman0000@gmail.com",
        "isVerified": true,
        "fcmToken": "YOUR_FCM_TOKEN"
    },
    "message": "user details updated successfully"
}

GET Profile

In this request you can get your profile and account data for any user by id

Important Note:you must active your account first. you can active account by verify it

 http://127.0.0.1:8080/user/profile

Request Headers

Authorization:Bearer TOKEN

Body raw (json)

{
    "userId":"USER_ID"
}

Response

{
    "status": true,
    "data": {
        "userID": "63d5b2c8db392954ecae9737",
        "userToken": null,
        "userName": "Adel Ayman",
        "email": "adelayman0000@gmail.com",
        "isVerified": true,
        "fcmToken": "YOUR_FCM_TOKEN"
    },
    "message": "user profile has got successfully"
}

POST Send OTP

Finally you will know how to active your account. In this request you can request send verification code to your email to complete your acccount setup and active it

 http://127.0.0.1:8080/user/send-email-code

Request Headers

Authorization:Bearer TOKEN Response

{
    "status": true,
    "data": null,
    "message": "otp code has sent successfully"
}

POST Verify OTP

In this request you can complete verification of your account by verify the code sent in your email

 http://127.0.0.1:8080/user/verify-code

Request Headers

Authorization:Bearer TOKEN

Query Params

+ otp_code(*required)

Response

{
    "status": true,
    "data": {
        "userID": "63d5b2c8db392954ecae9737",
        "userToken": "TOKEN",
        "userName": "Adel Ayman",
        "email": "adelayman0000@gmail.com",
        "isVerified": true,
        "fcmToken": "YOUR_FCM_TOKEN"
    },
    "message": "Account has verified successfully"
}

DEL Delete Account

Here you can delete your account

 http://127.0.0.1:8080/user

Request Headers

Authorization:Bearer TOKEN

Response

{
    "status": true,
    "data": null,
    "message": "room has deleted successfully"
}

Rooms endpoint

Introduction

In this part you will find "calling rooms" operators you can make such as

Create New Room
Join To Room
Delete Created Room
Get Room Informations
Get Your Rooms Important Note:all requests here required active account. you can active account by verify it

Operators

POST Create Room

In this request you can create new room There is 3 types of rooms 1:LINK 2:FACETIME 3:AUDIO

 http://127.0.0.1:8080/rooms

Request Headers

Authorization:Bearer TOKEN

Create Link Room Body raw (json)

{
    "roomType":"LINK"
}

Create FACETIME Room Body raw (json)

{
    "roomType":"FACETIME",
    "participantsEmails":["adelayman0000@gmail.com"]
}

roomType = EnumClass[LINK,FACETIME,AUDIO]

Response

{
    "status": true,
    "data": {
        "roomId": "63d710a884f8db3d80ca4c7d",
        "roomType": {
            "id": 2,
            "type": "FaceTime"
        },
        "roomAuthor": "63d5b2c8db392954ecae9737",
        "participants": [
            {
                "userEmail": "adelayman0000@gmail.com",
                "userName": "Adel Ayman",
                "userId": "63d5b2c8db392954ecae9737",
                "missedCall": true
            }
        ],
        "time": "2023-01-30T02:34:48.542"
    },
    "message": "room created successfully"
}

POST Join Room

Join to room you have invited to it (you should be participant). replace {ROOM_ID} with the id of room

 http://127.0.0.1:8080/rooms/{note_id}

Request Headers

Authorization:Bearer TOKEN

Body raw (json)

{
    "roomId":"ROOM_ID"
}

Response

{
    "status": true,
    "data": {
        "roomId": "63d710a884f8db3d80ca4c7d",
        "roomType": {
            "id": 2,
            "type": "FaceTime"
        },
        "roomAuthor": "test",
        "participants": [
            {
                "userEmail": "adelayman0000@gmail.com",
                "userName": "Adel Ayman",
                "userId": "63d5b2c8db392954ecae9737",
                "missedCall": false
            }
        ],
        "time": "2023-01-30T02:34:48.542"
    },
    "message": "user has joined successfully"
}

DEL Delete Room

Delete room you have created

replace {ROOM_ID} with the id of room you want to delete

 http://127.0.0.1:8080/rooms/{ROOM_ID}

Request Headers

Authorization:Bearer TOKEN

Response

{
  "status": true,
  "data": null,
  "message": "room has deleted successfully"
}

GET Get Room Info

In this request you will get the info of room

replace {ROOM_ID} with the id of room you want to delete

 http://127.0.0.1:8080/rooms/{ROOM_ID}

Request Headers

Authorization:Bearer TOKEN

Response

{
    "status": true,
    "data": {
        "roomId": "63d6e8ea04b18a106cf80991",
        "roomType": {
            "id": 1,
            "type": "Link"
        },
        "roomAuthor": "63d5b2c8db392954ecae9737",
        "participants": null,
        "time": "2023-01-29T23:45:14.572"
    },
    "message": "room info has got successfully"
}

GET Get User Rooms

Here You can get all rooms you joined to them

 http://127.0.0.1:8080/rooms

Request Headers

Authorization:Bearer TOKEN

Response

{
    "status": true,
    "data": [
        {
            "roomId": "63d70ffd508d7c2a2be07d3a",
            "roomType": {
                "id": 1,
                "type": "Link"
            },
            "roomAuthor": "63d5b2c8db392954ecae9737",
            "participants": null,
            "time": "2023-01-30T02:31:57.618"
        },
        {
            "roomId": "63d710a884f8db3d80ca4c7d",
            "roomType": {
                "id": 2,
                "type": "FaceTime"
            },
            "roomAuthor": "63d5b2c8db392954ecae9737",
            "participants": [
                {
                    "userEmail": "adelayman0000@gmail.com",
                    "userName": "Adel Ayman",
                    "userId": "63d5b2c8db392954ecae9737",
                    "missedCall": true
                }
            ],
            "time": "2023-01-30T02:34:48.542"
        }...........
    ],
    "message": "rooms have got successfully"
}

Built With 🛠

Kotlin
Ktor
Coroutines
KMongo
Clean architecture
JWT Auth
Koin
Repository pattern
jackson.

Project Structure

📦API
 ┣ 📂data
 ┃ ┣ 📂models
 ┃ ┃ ┣ 📜CallInvitationDataModel.kt
 ┃ ┃ ┣ 📜CallInvitationRequestModel.kt
 ┃ ┃ ┣ 📜Participant.kt
 ┃ ┃ ┣ 📜Room.kt
 ┃ ┃ ┗ 📜User.kt
 ┃ ┣ 📂repositories
 ┃ ┃ ┣ 📜RoomRepositoryImpl.kt
 ┃ ┃ ┗ 📜UserRepositoryImpl.kt
 ┃ ┣ 📂sources
 ┃ ┃ ┣ 📂roomDataSources
 ┃ ┃ ┃ ┣ 📜FcmRemoteDataSource.kt
 ┃ ┃ ┃ ┗ 📜RoomRemoteDataSource.kt
 ┃ ┃ ┗ 📂userDataSources
 ┃ ┃ ┃ ┗ 📜UserRemoteDataSource.kt
 ┃ ┗ 📂utilities
 ┃ ┃ ┣ 📂extensions
 ┃ ┃ ┃ ┣ 📜RoomExtensions.kt
 ┃ ┃ ┃ ┗ 📜UserExtensions.kt
 ┃ ┃ ┣ 📜Constants.kt
 ┃ ┃ ┗ 📜UserJWTConfig.kt
 ┣ 📂di
 ┃ ┗ 📂modules
 ┃ ┃ ┗ 📜MainModule.kt
 ┣ 📂domain
 ┃ ┣ 📂models
 ┃ ┃ ┣ 📜BaseResponse.kt
 ┃ ┃ ┣ 📜ParticipantModel.kt
 ┃ ┃ ┣ 📜RoomModel.kt
 ┃ ┃ ┣ 📜RoomType.kt
 ┃ ┃ ┗ 📜UserModel.kt
 ┃ ┣ 📂repositories
 ┃ ┃ ┣ 📜RoomRepository.kt
 ┃ ┃ ┗ 📜UserRepository.kt
 ┃ ┗ 📂usecases
 ┃ ┃ ┣ 📜CreateRoomUseCase.kt
 ┃ ┃ ┣ 📜DeleteAccountUseCase.kt
 ┃ ┃ ┣ 📜DeleteRoomUseCase.kt
 ┃ ┃ ┣ 📜GetRoomInfoUseCase.kt
 ┃ ┃ ┣ 📜GetUserFcmTokenUseCase.kt
 ┃ ┃ ┣ 📜GetUserProfileUseCase.kt
 ┃ ┃ ┣ 📜GetUserRoomsUseCase.kt
 ┃ ┃ ┣ 📜JoinRoomUseCase.kt
 ┃ ┃ ┣ 📜LoginUseCase.kt
 ┃ ┃ ┣ 📜RegisterUseCase.kt
 ┃ ┃ ┣ 📜SendCallInvitationUseCase.kt
 ┃ ┃ ┣ 📜SendEmailVerifyCodeUseCase.kt
 ┃ ┃ ┣ 📜UpdateUserDataUseCase.kt
 ┃ ┃ ┗ 📜VerifyCodeUseCase.kt
 ┣ 📂plugins
 ┃ ┣ 📜Monitoring.kt
 ┃ ┣ 📜Routing.kt
 ┃ ┣ 📜Security.kt
 ┃ ┣ 📜Serialization.kt
 ┃ ┗ 📜Sockets.kt
 ┣ 📂routes
 ┃ ┣ 📂rooms
 ┃ ┃ ┣ 📂requestModels
 ┃ ┃ ┃ ┣ 📜CreateRoomParams.kt
 ┃ ┃ ┃ ┗ 📜JoinRoomParams.kt
 ┃ ┃ ┗ 📜roomsRoute.kt
 ┃ ┗ 📂user
 ┃ ┃ ┣ 📂requestsModels
 ┃ ┃ ┃ ┣ 📜CreateUserParams.kt
 ┃ ┃ ┃ ┣ 📜UpdateUserParams.kt
 ┃ ┃ ┃ ┣ 📜UpdateUserTokenParams.kt
 ┃ ┃ ┃ ┗ 📜UserLoginParams.kt
 ┃ ┃ ┗ 📜userRoute.kt
 ┗ 📜Application.kt

LICENSE


Copyright (c) 2022 adelayman1

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.```

Name		Name	Last commit message	Last commit date
Latest commit History 24 Commits
gradle/wrapper		gradle/wrapper
src		src
.gitignore		.gitignore
README.md		README.md
build.gradle.kts		build.gradle.kts
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
settings.gradle.kts		settings.gradle.kts

adelayman1/FaceTimeCloneAPI

Folders and files

Latest commit

History

Repository files navigation

HttpFaceTimeCloneAPI

Table Of Content

Endpoints

User endpoint

Introduction

Operators

POST Login

POST Register

Fcm Token

PATCH Edit FCM Token

Fcm Token

GET Get FCM Token

PATCH Edit Profile

GET Profile

POST Send OTP

POST Verify OTP

DEL Delete Account

Rooms endpoint

Introduction

Operators

POST Create Room

POST Join Room

DEL Delete Room

GET Get Room Info

GET Get User Rooms

Built With 🛠

Project Structure

LICENSE

About

Topics

Resources

Stars

Watchers

Forks

Languages