[RESTful Web-service Documentation]
go top

get-user-deposit

returns the available deposit of an account and the URL where to buy new deposit.
If you request the available deposit of an corporate sub account, you will also see the available deposit of the main account

Parameter

Parameter (*=required)
Possible values
Default value
Description
lang [string, single value]
  • da
  • de
  • en
  • es
  • it
  • pl
  • pt

en
language

see also get-user-content-langs for getting all language values dynamically

User-Authentication

optional  (if you call this method without a token, then the method returns the deposit from the API-key account. Otherwise, it returns the deposit from the ressource owner's account of the respective token.)

Endpoint

http://rest.panthermedia.net/get-user-deposit

Sample Request

POST http://rest.panthermedia.net/get-user-deposit
Accept-Version: 1.0
Content-Type: application/x-www-form-urlencoded
api_key=a5e7b0dada779347e0fdd4db91ad883d0592aaca031e2c81234f3cb8008fdd1f&access_key=9de82c2a78df66e615274eec2622b53795abb2dd&timestamp=Thu%2C%2002%20Aug%202012%2005%3A54%3A55%20UTC&nonce=123&algo=sha1&lang=en

Sample Answer

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rsp stat="ok">
  <api_key>a5e7b0dada779347e0fdd4db91ad883d0592aaca031e2c81234f3cb8008fdd1f</api_key>
  <deposits total="5">
    <deposit type="singlebuy" name="Credits" deposit-remaining="768" deposit-remaining-percent="76" deposit-total="1000" currency="credits" valid-until="unlimited"/>
    <deposit type="singlebuy" name="EUR" deposit-remaining="365.90" deposit-remaining-percent="n/a" deposit-total="n/a" currency="eur" valid-until="unlimited"/>
    <deposit type="subscription" name="Subscription (Web) 3/Month" deposit-remaining="0" deposit-remaining-percent="0" deposit-total="10" currency="downloads" valid-until="07/07/2015"/>
    <deposit type="subscription" name="Subscription (XXL) 12/Month" deposit-remaining="0" deposit-remaining-percent="0" deposit-total="5" currency="downloads" valid-until="07/07/2015"/>
    <deposit type="subscription" name="Subscription (XXL) 500/Month" deposit-remaining="5" deposit-remaining-percent="1" deposit-total="5" currency="downloads" valid-until="09/08/2016"/>
  </deposits>
  <buy_deposit_url><![CDATA[http://stockagency.panthermedia.net/cms/credits]]></buy_deposit_url> 
</rsp>