API

Auth

API HTTPS endpoint: https://www.zamenej.sk/api
API key: zašlite nám e-mail na info@zamenej.sk

Každý request musí obsahovať POST parameter apikey.

 

Kontrola kupónu

Request

POST /coupon/check

POST parameters:

  • couponID (string)

 

JSON Return

{ "coupon": { "id":"ZM11234567890", "status":"USED", "used":"1", "usedTime":"2012-12-12 17:02", "type":"0", "typePrice":"1.00", "typeName":"Nazov typu kuponu" }, "deal": { "id":"1634", "title":"Nazov ponuky", "url":"http:\/\/www.zamenej.sk\/zlava\/info\/url-na-zlavu" } }

 

Return fields

"status":

  • VALID
  • USED
  • CANCELLED

"used":

  • 0
  • 1

"type":

  • typ kupónu podľa zoznamu na stránke ponuky, začína nulou

"typePrice":

  • cena kupónu po zľave (formát 99.99, t.j. 2 desatinné miesta)

 

Označovanie kupónu ako použitý

Request

POST /coupon/mark

POST parameters:

  • couponID (string) - ID kupónu ZMXXXXXXXXXXX
  • couponCode (string) - [optional] - Heslo 3 číslice

 

JSON Return

{ "coupon": { "id":"ZM11234567890", "status":"MARKED", "used":"1", "usedTime":"2012-12-12 17:02", "type":"0", "typePrice":"1.00", "typeName":"Nazov kuponu" }, "deal": { "id":"1634", "title":"Nazov ponuky", "url":"http:\/\/www.zamenej.sk\/zlava\/info\/url" } }

 

Return fields

"status":

  • MARKED
  • ALREADY_USED
  • CANCELLED

 

API Statuses/Error Codes

  • 9000 - Server error
  • 9001 - Invalid API key
  • 9002 - Invalid coupon ID
  • 9003 - User not authorized for this deal
  • 9004 - Invalid coupon Code

 

Mestá

Request

GET /locations

GET parameters:

  • žiadne

Return fields

  • id (integer)
  • name (string) - Názov mesta
  • slug (string) - Slug mesta používaný v parametroch

 

Kategórie

Request

GET /categories

GET parameters:

  • main [ 0 | 1 ]
    • 0: vráti všetky kategórie
    • 1: vráti iba hlavné kategórie

Return fields

  • id (integer)
  • name (string) - Názov kategórie
  • slug (string) - Slug kategórie používaný v parametroch