Sign In with Party Social

Get Started

Making an app requires Party Social Pro.

First, create an app at https://party-social.com/apps/create. After you can created the app, create a URL by clicking "Create URL," and select your redirect URL. The URL should look like this:

https://party-social.com/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=http://example.com

Design a Button to Sign in With Party Social. After the user signs in, they will be redirected to your URL with two parameters. One is the auth code and the other is state, if set. The auth code can be used to get the user's display name, username, and profile picture.

Exchange Authorization Code for Access Token

POST /token

Send a POST request to the token endpoint

Headers

Name	Value
Content-Type	application/json

Body

Name	Value
code	<auth code>
client_id	<client id>
client_secret	<client secret>
redirect_uri	<redirect url>

Response

200

{ 
    access_token: "accessToken",
    token_type: "bearer", 
    expires_in: 3600 
}

400

Fetch User's Info

The auth code expires in 5 minutes.

GET /auth/user

Get the user's info

Headers

Name	Value
Content-Type	application/json
Authorization	<access token>
client_id	<client id>

Response

200

{
  uid: "User's UID",
  photoURL: "User's PFP",
  name: "User's Display Name",
  username: "User's Username",
  token: "CUSTOM TOKEN"
}

400

401

500

To make a custom client, you must use the CUSTOM TOKEN to connect with Socket.io.

Example

const params = new URLSearchParams(window.location.search)

fetch('http://api.party-social.com/auth/user', {
    headers: {
        authorization: params.get('code'),
        client_id: params.get('client_id'),
    }
}).then(req => req.json()).then(data => {
    localStorage.setItem("user", data.token)
    location = '/'
})

Example

An example can be found on GitHub: https://github.com/PartySocial/oauth-example