Skip to content
merran
GitHubInstall

Merran documentation API & integrations

Test the Kroger app

POST
/api/settings/server/kroger/test
curl --request POST \
--url http://localhost:3000/api/settings/server/kroger/test \
--header 'Content-Type: application/json' \
--cookie merran.session_token=<merran.session_token> \
--data '{ "clientId": "merran-abc123" }'

Server admins only. Asks Kroger for a token with a client ID and secret, before saving them, or with the saved ones.

Media typeapplication/json

A Kroger developer app’s client ID and secret to test before saving them. Either left out is the saved one.

object
clientId
string
>= 1 characters <= 200 characters
clientSecret
string
>= 1 characters <= 200 characters

Example

{
"clientId": "merran-abc123"
}

Kroger took them.

Media typeapplication/json
object
ok
required
boolean

Example

{
"ok": true
}

No client ID and secret to test.

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
fields
object
key
additional properties
string

Example

{
"error": {
"code": "not_found",
"message": "There's nothing here.",
"fields": {
"name": "Give it a name."
}
}
}

Not signed in.

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
fields
object
key
additional properties
string

Example

{
"error": {
"code": "not_found",
"message": "There's nothing here.",
"fields": {
"name": "Give it a name."
}
}
}

Not allowed.

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
fields
object
key
additional properties
string

Example

{
"error": {
"code": "not_found",
"message": "There's nothing here.",
"fields": {
"name": "Give it a name."
}
}
}

Kroger refused them.

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
fields
object
key
additional properties
string

Example

{
"error": {
"code": "not_found",
"message": "There's nothing here.",
"fields": {
"name": "Give it a name."
}
}
}

Kroger didn’t answer.

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
fields
object
key
additional properties
string

Example

{
"error": {
"code": "not_found",
"message": "There's nothing here.",
"fields": {
"name": "Give it a name."
}
}
}

© 2026 Kyle Johnson. Documentation: CC BY 4.0. Merran: AGPL-3.0-or-later.