Connect Widget

Create grant request

post

Creates a new GNAP grant request.

Header parameters

x-client-idstringRequired

detached-jwsstringRequired

Detached JSON Web Signature (JWS) token for request authentication and verification

Body

access_tokenobjectRequired

clientstringRequired

The client ID of the client requesting the access token.

userobjectOptional

interactobjectRequired

providersstring · enum[]Optional

The providers enabled for the interaction.

Responses

application/json

objectOptional

post

HTTPcURLJavaScriptPython

POST /v1/grant HTTP/1.1
Host: auth.armory.playnarval.com
x-client-id: text
detached-jws: text
Content-Type: application/json
Accept: */*
Content-Length: 248

{
  "access_token": {
    "label": "text",
    "access": [
      {
        "type": "text",
        "actions": [
          "text"
        ],
        "locations": [
          "text"
        ]
      }
    ]
  },
  "client": "text",
  "user": {
    "id": "text"
  },
  "interact": {
    "start": [
      "text"
    ],
    "finish": {
      "method": "text",
      "uri": "text",
      "nonce": "text"
    }
  },
  "providers": [
    "anchorage"
  ]
}

{
  "interact": {
    "redirect": "text",
    "finish": "text",
    "expires_in": 1
  },
  "continue": {
    "access_token": {
      "value": "text"
    },
    "uri": "text"
  }
}

Continue grant request

post

Continues an existing GNAP authorization process.

Header parameters

x-client-idstringRequired

authorizationstringRequired

detached-jwsstringRequired

Detached JSON Web Signature (JWS) token for request authentication and verification

Body

interact_refstringRequired

The interact_ref of the grant request

Responses

application/json

objectOptional

post

HTTPcURLJavaScriptPython

POST /v1/continue HTTP/1.1
Host: auth.armory.playnarval.com
x-client-id: text
authorization: text
detached-jws: text
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "interact_ref": "text"
}

{
  "access_token": {
    "label": "text",
    "value": "text",
    "manage": {
      "uri": "text",
      "access_token": {
        "value": "text"
      }
    },
    "access": [
      {
        "type": "text",
        "actions": [
          "text"
        ],
        "locations": [
          "text"
        ],
        "identifier": "text"
      }
    ],
    "expires_in": 1
  }
}