Postman + Login - Violet Documentation

curl -s --request POST \
   --url 'sandbox-api.violet.io/v1/login' \
   --header 'X-Violet-App-Secret: APPSECRET' \
   --header 'X-Violet-App-Id: APPID' \
   --header 'Content-type: application/json' \
   --data '{
  "username": "",
  "password": ""
}'

{
  "id": 0,
  "first_name": "string",
  "last_name": "string",
  "password": "string",
  "email": "string",
  "merchant_id": 0,
  "type": "ADMIN",
  "verified": false,
  "status": "INACTIVE",
  "date_created": "2022-03-23T14:25:41.517Z",
  "date_last_modified": "2022-03-23T14:25:41.517Z",
  "roles": [
    {
      "name": "string",
      "description": "string",
      "permissions": [
        {
          "name": "string",
          "description": "string"
        }
      ]
    }
  ],
  "token": "string",
  "refresh_token": "string"
}

This section takes you through using Postman to test the Violet APIs. Make sure you have already signed up at channel.violet.io/signup and created an application in the step prior. If you haven’t, please go through Create a Violet Application

The Violet Postman Collection is available here: Violet Postman Collection

If you would like to fork the collection into your Postman workspace, you can do so here: Fork Violet Postman Collection

You will need your App ID and App Secret in order to complete this step.

Initial Postman Setup

The Violet Postman Collection uses Collection Variables to store your App Id and App Secret and pass them in to all requests across the collection. Follow this guide to find where to set these values in our Collection.

You can ignore the other values in the variable list, these are used by the scripts and populated automatically based on the result of the previous request. (If you are curious how that works, check out the test tab on some of the requests, they will have a green dot if there is info there.)

This API tests your connection to Violet by logging into your Application. Add X-Violet-App-Id and X-Violet-App-Secret added to your headers for login. These are available from the application you created on channel.violet.io. Every request after login will require these header params for authentication, along with the X-Violet-Token that you get from login and refreshing your token.

While your username and password will be the same across environments (test and live) as will your X-Violet-App-Id, this is not true for your X-Violet-App-Secret.

The X-Violet-App-Secret you retrieve from the Channel dashboard is different depending on the live/test mode toggle. You must use the correct app secret that corresponds to the environment you are trying to login to: test for sandbox-api.violet.io and live for api.violet.io.

In addition to the headers mentioned above, include your username (your username is the email you signed up with) and password. If successful, an access token will be returned in the response body for use in additional requests against the API along with information about your API.

While the User Management feature of the Dashboard allows multiple users to login and view the dashboard, only an App’s “Owner” username and password will allow you to generate a token. You can view who your App’s owner is on the team view

HEADER PARAMETERS

X-Violet-App-Secret

String

required

The secret for your Violet App

X-Violet-App-Id

String

required

The ID for your Violet App

BODY PARAMETERS

username

String

required

The email you signed up for Violet with.

password

String

required

Password used on signup

If you are using our Postman collection, you can add X-Violet-App-Id and X-Violet-App-Secret in the environment variables.

Refresh your Token

Use the Refresh Token to get a new token. This is an operation you will have to do on a regular basis. You can use your App Id and App Secret with a refresh token to get a new token. This saves the step of having to send your username and password each time to get a new token.

Headers

X-Violet-App-Secret

string

Please note that App Secrets are different depending on environment (test/live) please make sure you have retrieved the correct app secret from the Dashboard.

X-Violet-App-Id

integer

Body

application/json

username

string

required

Username

password

string

required

Password

Response

default - application/json

integer

first_name

string

required

The users first name

last_name

string

required

The users last name

password

string

required

The users raw desired password

string

required

The users unique email address

type

enum<string>

required

The allowed values for the user type

Available options:

SUPER_ADMIN,

ADMIN,

MERCHANT,

USER,

DEVELOPER,

INFLUENCER,

HYBRID,

OTHER

verified

boolean

If a user has verified their emailed address

status

enum<string>

The status of the user. Note the lower case possible values as opposed to other status enums, this is a legacy issue that is maintained for backwards compatibility.

Available options:

inactive,

active,

disabled,

for_deletion

date_created

string

Date of creation

date_last_modified

string

Date of last update

roles

object[]

tos_accepted

boolean

payment_configured

boolean

Is the Users Payment Settings Configured

privacy_policy_accepted

boolean

country_code

enum<string>

Country Code

Available options:

US,

AU,

AT,

BE,

CA,

DK,

FI,

FR,

DE,

HK,

IE,

IT,

JP,

LU,

MX,

NL,

NZ,

NO,

PT,

SG,

ES,

SE,

CH,

GB,

AF,

AX,

AL,

DZ,

AS,

AD,

AO,

AI,

AQ,

AG,

AR,

AM,

AW,

AZ,

BS,

BH,

BD,

BB,

BY,

BZ,

BJ,

BM,

BT,

BO,

BA,

BW,

BV,

BR,

IO,

BN,

BG,

BF,

BI,

KH,

CM,

CV,

KY,

CF,

TD,

CL,

CN,

CX,

CC,

CO,

KM,

CG,

CD,

CK,

CR,

CI,

HR,

CU,

CY,

CZ,

DJ,

DM,

DO,

EC,

EG,

SV,

GQ,

ER,

EE,

ET,

FK,

FO,

FJ,

GF,

PF,

TF,

GA,

GM,

GE,

GH,

GI,

GR,

GL,

GD,

GP,

GU,

GT,

GG,

GN,

GW,

GY,

HT,

HM,

VA,

HN,

HU,

IS,

IN,

ID,

IR,

IQ,

IM,

IL,

JM,

JE,

JO,

KZ,

KE,

KI,

KP,

KR,

KW,

KG,

LA,

LV,

LB,

LS,

LR,

LY,

LI,

LT,

MO,

MK,

MG,

MW,

MY,

MV,

ML,

MT,

MH,

MQ,

MR,

MU,

YT,

FM,

MD,

MC,

MN,

ME,

MS,

MA,

MZ,

MM,

NA,

NR,

NP,

AN,

NC,

NI,

NE,

NG,

NU,

NF,

MP,

OM,

PK,

PW,

PS,

PA,

PG,

PY,

PE,

PH,

PN,

PL,

PR,

QA,

RE,

RO,

RU,

RW,

SH,

KN,

LC,

PM,

VC,

WS,

SM,

ST,

SA,

SN,

RS,

SC,

SL,

SK,

SI,

SB,

SO,

ZA,

GS,

LK,

SD,

SR,

SJ,

SZ,

SY,

TW,

TJ,

TZ,

TH,

TL,

TG,

TK,

TO,

TT,

TN,

TR,

TM,

TC,

TV,

UG,

UA,

AE,

UM,

UY,

UZ,

VU,

VE,

VN,

VG,

VI,

WF,

EH,

YE,

ZM,

ZW

token

string

Token

refresh_token

string

Refresh Token

merchant_id

integer

Merchant ID. Should only be used during merchant validation. Expect property to be null.

merchant_ids

integer[]

Merchant IDs

store_url

string

Store Url

Was this page helpful?

Create a Violet Application Overview

curl -s --request POST \
   --url 'sandbox-api.violet.io/v1/login' \
   --header 'X-Violet-App-Secret: APPSECRET' \
   --header 'X-Violet-App-Id: APPID' \
   --header 'Content-type: application/json' \
   --data '{
  "username": "",
  "password": ""
}'

{
  "id": 0,
  "first_name": "string",
  "last_name": "string",
  "password": "string",
  "email": "string",
  "merchant_id": 0,
  "type": "ADMIN",
  "verified": false,
  "status": "INACTIVE",
  "date_created": "2022-03-23T14:25:41.517Z",
  "date_last_modified": "2022-03-23T14:25:41.517Z",
  "roles": [
    {
      "name": "string",
      "description": "string",
      "permissions": [
        {
          "name": "string",
          "description": "string"
        }
      ]
    }
  ],
  "token": "string",
  "refresh_token": "string"
}

Introduction

Getting Started

Checkout

Violet Connect

Relay

Product Info

Support

​Initial Postman Setup

​Login

Headers

Body

Response

Initial Postman Setup

Login