Partner API
Use the XML interfaces we provide to recreate the Plati product catalog with a custom theme on your website.
More information about the Plati partner program is available in Info.
XML API:
List of items in category
| Request URL | https://plati.io/xml/goods.asp |
|---|---|
| Method: | POST |
| Request data: |
<digiseller.request>
<guid_agent></guid_agent>
<id_section></id_section>
<lang>en-US</lang>
<encoding></encoding>
<page></page>
<rows></rows>
<currency></currency>
<order></order>
</digiseller.request>
|
Request parameters
| Name | Use | Comment |
|---|---|---|
| guid_agent | your Partner UID | You need to log in or register as a partner using the form on the right. |
| id_section | category id | integer |
| lang | ru-RU | en-US | |
| encoding | utf-8 | |
| page | page number (if you do not specify the page number, then displays the first page) | integer |
| rows | number of items per page (maximum 500) | integer |
| currency | currency to display prices of items | USD | RUR | EUR | UAH |
| order | way to sort items |
name — name asc nameDESC — name desc price — price desc priceDESC — price asc rating - sellers ratings asc ratingDESC - sellers ratings desc if not specified, then sorted by rating the seller and the amount paid for the recommended |
Response format
| Response sample |
<digiseller.response>
<retval></retval>
<retdesc></retdesc>
<id_section></id_section>
<name_section></name_section>
<cnt_goods></cnt_goods>
<pages></pages>
<page></page>
<order></order>
<rows cnt="">
<row id="">
<id_goods></id_goods>
<name_goods></name_goods>
<price></price>
<currency></currency>
<discount></discount>
<gift></gift>
<reward></reward>
<id_seller></id_seller>
<name_seller></name_seller>
<rating></rating>
<summpay></summpay>
<statistics>
<cnt_sell></cnt_sell>
<cnt_return></cnt_return>
<cnt_goodresponses></cnt_goodresponses>
<cnt_badresponses></cnt_badresponses>
</statistics>
<sale_info>
<common_base_price></common_base_price>
<common_price_usd></common_price_usd>
<common_price_rur></common_price_rur>
<common_price_eur></common_price_eur>
<common_price_uah></common_price_uah>
<sale_percent></sale_percent>
</sale_info>
</row>
</rows>
</digiseller.response>
|
|---|
Response parameters
| Name | Use | Comment |
|---|---|---|
| retval | result code |
0 — request successfully processed -1 — missing or invalid parameter is specified (guid_agent) -2 — missing or invalid parameter is specified (id_section) -3 — missing or invalid parameter is specified (page) -4 — missing or invalid parameter is specified (rows) 4 — category has not been found |
| retdesc | description of result code | |
| id_section | category id | |
| name_section | category name | |
| cnt_goods | number of items of category | |
| pages | total pages num | |
| page | page number | |
| order | selected sorting method | |
| rows | rows parameters | |
| rows \ row | row parameters | id — serial row number |
| rows \ row \ id_goods | item id | |
| rows \ row \ name_goods | item name | |
| rows \ row \ price | price | |
| rows \ row \ currency | currency type | |
| rows \ row \ discount | discount | yes | no |
| rows \ row \ gift | gift card | yes | no |
| rows \ row \ reward | procent | partner reward for selling this item (%) |
| rows \ row \ id_seller | seller ID | |
| rows \ row \ name_seller | short seller name | |
| rows \ row \ rating | sellers rating | |
| rows \ row \ summpay | the amount of $ paid for a recommended | |
| rows \ row \ statistics | statistics of this item | |
| rows \ row \ statistics \ cnt_sell | sold | |
| rows \ row \ statistics \ cnt_return | number of refunds | |
| rows \ row \ statistics \ cnt_goodresponses | positive feedbacks | |
| rows \ row \ statistics \ cnt_badresponses | negative feedbacks | |
| rows \ row \ sale_info | sale information | |
| rows \ row \ sale_info \ common_base_price | base price before sale | |
| rows \ row \ sale_info \ common_price_usd | price before sale. currency: USD | |
| rows \ row \ sale_info \ common_price_rur | price before sale. currency: RUR | |
| rows \ row \ sale_info \ common_price_eur | price before sale. currency: EUR | |
| rows \ row \ sale_info \ common_price_uah | price before sale. currency: UAH | |
| rows \ row \ sale_info \ sale_percent | discount percent |