SOCIAL API

This API is developed using the PHP Slim Framework, In this API you can use thease feature.

• Create an account ( An email verification will be sent to user email address when they rgistered an account )
• Login into account ( User can login into their account when they will successfully verified their account )
• Send Email Verification Code (You can add a feature that user can send email verifcation code again to their email address )
• Update Password ( User can update password, An email will also be send when they succesfully changed their password )
• Forgot Password ( User can make a request that they have forgot their password, An OTP will be send to user's email address )
• Reset Password ( User can reset password, by using the OTP which they have recieved, An email will also be send when they succesfully changed their password )
• Users List ( To view all usesrs information e.g. Name, Email,Id. Need authuntication to view users informations )
• Post Feed ( To Post the Feed. )
• Delete Feed ( To Delete the Feed )
• Retrive All Feed ( To retrive all feed )
• Retive All Feed Of Specific User ( You can retrive all post of a specific user by their username )
• Retrive A Single Post Using ( You can retrive a signle feed using the feedId )
• Like Feed ( To Like The Feed )
• Dislike Feed ( To Dislike The Feed )
• Post Feed Comment ( To Post Comments For The Feed )
• Delete Feed Comment ( To Delete a comment of Feed )

Feauter Explanation

To use this project's feature, you need to make changes only in Constants.php file, and that's it.

Set your database connection's information.

//Database Connection
define('DB_NAME', 'socialcodia');    //your database username
define('DB_USER', 'root');          //your database name
define('DB_PASS', '');              //your database password
define('DB_HOST', 'localhost');     //your database host name

And you also need to make change in website section of Constants.php file.

//Website Information
define('WEBSITE_DOMAIN', 'http://socialapi.socialcodia.ml');               //your domain name
define('WEBSITE_EMAIL', 'socialcodia@gmail.com');                    //your email address
define('WEBSITE_EMAIL_PASSWORD', 'password');                        //your email password
define('WEBSITE_EMAIL_FROM', 'Social Codia');                        // your website name here
define('WEBSITE_NAME', 'Social Codia');                              //your website name here
define('WEBSITE_OWNER_NAME', 'Umair Farooqui');                      //your name, we will send this name with email verification mail.

// JWT ( *JSON Web Token* ) Information
define('JWT_SECRET_TOKEN','SocialCodia');                              //Your JWT secret key here,

Note : In JWT_SECRET_TOKEN, Please use a very hard and dificult key which no one can guess that key.

Register An Account

To Create An Account, Accept only post request with three parameter

• Name
• Email
• Password

The end point is to Create or Register an account is register

Demo Url

• API Url http://socialapi.socialcodia.ml/register
• GUI Url http://socialui.socialcodia.ml/register

An email verification will be send to user email address when they registered an account into the system.

In verification email the verification link will be like this.

    http://socialapi.socialcodia.ml/verifyEmail/wdpWwmufazmit4Py2aYd7MsocialcodiavknYY3bKxS7okyO9NgpYTmufazmiTGsocialcodiaE=/$2y$10$GWEv1cnJo2YdGbmo4mrwA.LNsocialcodiai4sj8.EdxIZuyWX3fjRHEiBrBX2S

• Domain Name : (http://socialapi.socialcodia.ml/)
• End Point (verifyEmail)
• Encypted User Email (wdpWwmufazmit4Py2aYd7MsocialcodiavknYY3bKxS7okyO9NgpYTmufazmiTGsocialcodiaE=)
• Encypted Code ( $2y$10$GWEv1cnJo2YdGbmo4mrwA.LNsocialcodiai4sj8.EdxIZuyWX3fjRHEiBrBX2S )

Demo Url

• API Url http://socialapi.socialcodia.ml/verifyEmail/wdpWwmufazmit4Py2aYd7MsocialcodiavknYY3bKxS7okyO9NgpYTmufazmiTGsocialcodiaE=/$2y$10$GWEv1cnJo2YdGbmo4mrwA.LNsocialcodiai4sj8.EdxIZuyWX3fjRHEiBrBX2S

Send Email Verification Code Again

To Send The Email Verification Code again, Accept only post request with only one parameter

• Email

User can make the send email verification link code if there email address is not verified yet.

The end point of send email verification code is sendEmailVerfication

Demo Url

• API Url http://socialapi.socialcodia.ml/sendEmailVerfication
• GUI Url http://socialui.socialcodia.ml/sendEmailVerfication

Login Into Account

To Login into Account, Accept only post request with two parameter

• Email
• Password

The end point of login is login

When user provide their username & password credential for login, the request will return their public information with Token

The return infomration from the database will be like this.

{
    "error": false,
    "message": "Login Successfull",
    "user": {
        "id": 173,
        "name": "Social Codia",
        "email": "socialcodia@gmail.com",
        "image": "http://socialapi.socialcodia.ml/public/uploads/5ee743ba282bc.jpg",
        "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJzb2NpYWxjb2RpYS5uZXQiLCJpYXQiOjE1OTIyNDc5ODgsInVzZXJfaWQiOjE3M30.i_vxJ2AyrgLa5vL5L-FXKDRr5NVKDyDSHeZuccF7OT4"
    }
}

Demo Url

• API Url http://socialapi.socialcodia.ml/login
• GUI Url http://socialui.socialcodia.ml/login

Forgot Password

To send the Forgot Password request, Accept only post request with only one parameter

• Email

The end point of Forgot Password is forgotPassword

An OTP wil be sent to email address.

When you make a post request on the forgotPassword,

This will perform these Validation before sending an OTP to users email address.

• The Email parameter should not be empty.
• The Email Address is a Valid email address or not.
• The Email Address is Exist into your database server or not.
• The Email Address is Verified email address or not.

Demo Url

• API Url http://socialapi.socialcodia.ml/forgotPassword
• GUI Url http://socialui.socialcodia.ml/forgotPassword

Reset Password

To Reset the password, Accept only post request with three parameter

• Email
• OTP
• Password

The end point of Reset Password is resetPassword

When you make a request to Reset the password on resetPassword

This will perform some validation before varifying the OTP.

• The Email Email, OTP and Password should not be empty.
• The Email Address is a Valid email address or not.
• The Email Address is Exist into your database server or not.
• The Email Address is Verified email address or not.

Then they will check the OTP is correct or not, if correct then the new password will update into server.

Demo Url

• API Url http://socialapi.socialcodia.ml/resetPassword
• GUI Url http://socialui.socialcodia.ml/resetPassword

Update Account Password

To update or changed the current password, Accept post request with two parameter with header.

• Password
• newPassword

The Token must be go in header, The token is mandatory for acception of request.

• Token

Before returninng any data, This request will verify the current login users information using Token, and after that this will fetch the user id from the Token and update their password into database. An email notification also be sent when they will change their password with Time, Date and Ip Address.

The end point of update password is updatePassword

Demo Url

• API Url http://socialapi.socialcodia.ml/updatePassword
• GUI Url http://socialui.socialcodia.ml/settings

an verification code will be sent to user email address when they successfull updated their password.

When any user reset there password or changed there password, a confirmation email will be deliver to their registered email address that the password has been changed,

For security reason, The email will be deliver with three parameter Time and Date and Ip Address .

View Users List

To view all users list from database, Authuntication is very compulsry for that, Any authunticated user can view the users public information list, e.g. Id, Name and Email,

To view the users public informations list, Accept only GET request with no parameter,

• This request will return the only the verified users public information.
• This request will take an authorization token to validate the user.

The end point of Users List is users

E.g Data Return From The Server

{
    "error": false,
    "message": "Users List Found",
    "users": [
        {
            "id": 157,
            "name": "Umair Farooqui",
            "email": "info.mufazmi@gmail.com",
            "image": "http://socialapi.socialcodia.net/public/uploads/5eeasfw53cdcde.png"
        },

        {
            "id": 173,
            "name": "Social Codia",
            "email": "socialcodia@gmail.com",
            "image": "http://socialapi.socialcodia.net/public/uploads/5ee7c753cdcde.png"
        }
    ]
}

Demo Url

• API Url http://socialapi.socialcodia.ml/users
• GUI Url http://socialui.socialcodia.ml/users

Note :- WHEN ANY USER LOGIN INTO SYSTEM USING THERE EMAIL AND PASSWORD CREDENTIAL, AN TOKEN WILL ALSO BE SENT TO USER vbWITH USER PUBLIC INFORMATION, SO AFTER COMPLETATION OF LOGIN PROCESS THE TOKEN IN HEADER IS REQUIRED FOR MAKING ANY REQUEST

Post Feed

To post the feed, Accept only post request with two parameter.

• postContent
• postImage

The postContent parameter is optional if the postImage parameter is not empty, same is here, if postContent is not empty then the postImage parameter will be optional.

At the end

you don't need to worry about that things, you only need to change the code of Constants.php File.

• You can check out the UI which is mainely developed for this project, @SocialCodia/RestUi

• Visit on the link to perform API Action, http://socialui.SocialCodia.ml

That's it! Now go build something cool.