Getting Started

Catalog Update

Order Management

Total Sales

Suppliers Details

Buyers Details

Getting started

1. How to get your API key?

To get your API key  you must request API Username and Password. 

Please send your request by email to [email protected]

 

2. How to get an Authorization Token?

Zester’s API requests require you to authenticate yourself (this excludes the login and tools endpoints). To get authenticated, you first have to get an access token.

 

  • Method: POST
  • URL: https://api.zester.co.il/Token
  • Headers Content Type:  application/x-www-form-urlencoded
  • Body: 
username:Given Username
password:Given Password
grant_type:password (insert the word “password”)

Add Your Heading Text Here

Sample Response:

Status: 200 OK

				
					RESPONSE : (JSON)
{
    "access_token": string,
    "token_type": string,
    "expires_in": number,
    "userName": string,
    "operator": string,
    "roles": string,
    "isSupplier": string,
    "name": string,
    "orderForApproved": string,
    "ParentId": string,
    "AllowedToSwitchContext": string,
    ".issued": string, // date format
    ".expires": string // date format
}

HTTP response codes

  • 200 — Success Everything went smooth.

  • 400 — Bad Request There was a validation error with the input.

  • 401 — Unauthorized Missing or incorrect JSON Web Token (JWT) in Authorization header.

  • 403 — Forbidden You are trying to request a resource you aren’t allowed to.

  • 404 — Not Found One or more of the required resources was not found, or you do not own the resource.

  • 500 — Internal Server Error This is an issue with Green Invoice’s servers processing your request. In most cases we are notified so that we can investigate the issue