post__auth_github

Code Samples

Shell

# You can also use wget
curl -X POST https://backend.flashback.tech/auth/github \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

HTTP

POST https://backend.flashback.tech/auth/github HTTP/1.1
Host: localhost:3000
Content-Type: application/json
Accept: application/json

JavaScript

const inputBody = '{
  "code": "abc123def456..."
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}'
};

fetch('https://backend.flashback.tech/auth/github',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

Ruby

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/json',
  'Accept' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.post 'https://backend.flashback.tech/auth/github',
  params: {
  }, headers: headers

p JSON.parse(result)

Python

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('https://backend.flashback.tech/auth/github', headers = headers)

print(r.json())

PHP

<?php

require 'vendor/autoload.php';

$headers = array(
    'Content-Type' => 'application/json',
    'Accept' => 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','https://backend.flashback.tech/auth/github', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

Java

URL obj = new URL("https://backend.flashback.tech/auth/github");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

Go

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "https://backend.flashback.tech/auth/github", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /auth/github

GitHub OAuth Authentication

Authenticate user with GitHub OAuth authorization code.

This endpoint handles GitHub OAuth authentication, similar to Google OAuth but using GitHub's OAuth flow. The system creates or updates user accounts based on GitHub profile information.

GitHub OAuth Flow:

1. Redirect user to GitHub OAuth consent screen

2. User authorizes your application

3. GitHub returns authorization code

4. Call this endpoint with the code

5. Receive authentication state with user info and tokens

Account Creation:

• Organization name derived from GitHub username or company

• Email from GitHub profile

• Profile image from GitHub avatar

Body parameter

{
  "code": "abc123def456..."
}

Parameters

Name	In	Type	Required	Description
body	body	object	true	none
» code	body	string	true	GitHub authorization code from OAuth consent screen

Example responses

200 Response

{
  "success": true,
  "message": "Authentication successful",
  "authState": {
    "user": {
      "email": "[email protected]",
      "name": "John Doe",
      "imageUrl": "https://avatars.githubusercontent.com/u/1234567"
    },
    "token": "string",
    "accessToken": "string",
    "refreshToken": "string",
    "expiresAt": 0,
    "provider": "GITHUB"
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	Authentication successful	Inline

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	none
» message	string	false	none	none
» authState	object	false	none	none
»» user	object	false	none	none
»»» email	string	false	none	User's email from GitHub
»»» name	string	false	none	User's display name from GitHub
»»» imageUrl	string	false	none	User's profile image URL from GitHub
»» token	string	false	none	JWT access token for API authentication
»» accessToken	string	false	none	GitHub access token for GitHub API calls
»» refreshToken	string	false	none	GitHub refresh token
»» expiresAt	integer	false	none	Token expiration timestamp
»» provider	string	false	none	Authentication provider

Enumerated Values

Property	Value
provider	GITHUB