Skip to content
go-api-boilerplate

Google's redirect back.

GET
/v1/google/callback
curl --request GET \
  --url https://example.com/api/user/v1/google/callback

Redirects to the web app. A sign-in goes to /sign-in/complete?code=…&next=… with a login code, valid for 2 minutes, for the auth service to redeem; a link goes to /profile?google=linked. A failure goes to /sign-in?google=<outcome>, or /profile?google=<outcome> when linking, where the outcome is denied (the user said no at Google), expired (start again), unverified (Google hasn’t verified the address), taken (the Google account or its address belongs to another account) or failed.

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
code
string
state
string
error
string

Responses

Section titled “Responses”

302

Section titled “302”

Go there.

Headers

Section titled “Headers”
Location
required
string format: uri-reference

401

Section titled “401”

No access token, or one that is invalid or expired.

Media typeapplication/problem+json

An RFC 9457 problem.

object
type
required
string
title
required
string
status
required
integer
detail

Written for the user.

string
instance
string
request_id
string
errors

What is wrong with each field of the request.

object
key
additional properties
string

Example generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "request_id": "example",
  "errors": {
    "additionalProperty": "example"
  }
}

Headers

Section titled “Headers”
WWW-Authenticate
required
string
Allowed value: Bearer

404

Section titled “404”

Google sign-in isn’t set up on this server.

Media typeapplication/problem+json

An RFC 9457 problem.

object
type
required
string
title
required
string
status
required
integer
detail

Written for the user.

string
instance
string
request_id
string
errors

What is wrong with each field of the request.

object
key
additional properties
string

Example generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "request_id": "example",
  "errors": {
    "additionalProperty": "example"
  }
}