I) EVC HTTP API for Resellers
==============================================================================
The HTTP API consists of four simple HTTP GET commands. You can even try them from the browser.
The purpose is to allow resellers to automate their relationship administration to their EVC reseller customers.


1) Checking if an EVC customer exists:
------------------------------------------------------------------------------
https://evc.de/services/api_resellercredits.asp?apiid=###&username=###&password=###&verb=checkevccustomer&customer=###
Note: This doesn't check if this is a personal customer of you. It checks the EVC customer base.


2) Creating a personal customer:
------------------------------------------------------------------------------
https://evc.de/services/api_resellercredits.asp?apiid=###&username=###&password=###&verb=addcustomer&customer=###
Note 1: A personal customer must already as EVC customer. Making him a personal customer allows him to see your reseller files
        and creates a personal account balance relationship with you.
Note 2: Only add customers who asked for this. Everything else will lead to customer complaints and we'd forced to stop such a behavior.


3) Checking a personal account balance:
------------------------------------------------------------------------------
https://evc.de/services/api_resellercredits.asp?apiid=###&username=###&password=###&verb=getcustomeraccount&customer=###


4) Setting a personal account balance:
------------------------------------------------------------------------------
https://evc.de/services/api_resellercredits.asp?apiid=###&username=###&password=###&verb=setcustomeraccount&customer=###&credits=###
Note: This is not recommended for adding/removing points because the customer might purchase at the same time, causing a wrong balance.


5) Adding to a personal account balance:
------------------------------------------------------------------------------
https://evc.de/services/api_resellercredits.asp?apiid=###&username=###&password=###&verb=addcustomeraccount&customer=###&credits=###
Note 1: This is the recommended way for adding/removing points. If the customer purchases at the *same* time, the balance will still be correct.
Note 2: The "credits" value can be negative, so you can subtract with this command as well.


6) Getting a list of recent purchases:
------------------------------------------------------------------------------
https://evc.de/services/api_resellercredits.asp?apiid=###&username=###&password=###&verb=getrecentpurchases&lastndays=###
Returns a JSON-formated list of the purchases performed in the last X (up to 99) days.
Sample output:
ok: JSON follows
{
   status: 'OK',
   data: [
      {
         Customer: 12345,
         Filename: 'sample.ols',
         ComputerName: 'my computer',
         IP: '123.45.67.89',
         Date: '1999-12-31T23:59:59',
      },
      ....
   ];
}


Testing:
------------------------------------------------------------------------------
You can use customer 33333 as a test customer.


Parameters:
------------------------------------------------------------------------------
The links above contain a few placeholders (####) that you need to replace before using them:
apiid    => The api key. Always: j34sbc93hb90
username => Your evc.de account number
password => Your API password. This is **NOT** your evc.de account password. It's a separate password that you get from the EVC office.
customer => The EVC customer number of the customer you want to handle
credits  => The credit value you want to set


Errors:
------------------------------------------------------------------------------
All commands return a text string that either begins with "ok: " or "fail: ". This may be followed by a text with more information or (in case of getcustomeraccount) the requested value.


Security:
------------------------------------------------------------------------------
Please keep the api, the apiid and your username / password combinations secrets. It is strongly recommended to use https:// for an encrypted connection.