REST API MGID for Advertising Agencies

* Please note that all API requests must be performed via HTTPS.

Table of contents

1. Getting token for advertising agency
2. Getting advertising agency clients list with financial stats
3. Getting one client financial stats
4. Getting financial stats of advertising agency
5. Getting data of advertising agency clients expences for a period
6. Clients balance replenishments from advertising agency wallet

 

Getting token for advertising agency

Transfered parameters:

Returned answer:

{
"token":"_current_token_", "refreshToken":"_token_for_updating_" "accountId":"_identifier_of_user_account__"
}

_current_token_  used for Advertising agency identification; _token_for_updating_- will be used in the next versions to update the current overdue token.

Possible errors:

If login does not exist system return "Login does not exist";

If you enter the wrong password returns the error "Incorrect password."

 

Getting advertising agency clients list  with financial stats

Transfered parameters:

Returned answer:

{
   clients:{
       "id":_identifier_of_client's_account_,
         "email":_client's_email_,
      "wallet":{
         "balance":_state_of_MG_wallet_,
         "credit":_overdraft_amount_,
         "income":_total_replenish_sum_
      }
   }
}

All sums tranfered in advertising agency currency.

Possible errors:

If transferred current token is invalid, returned error is "invalid token".

 

Getting one client financial stats

Transfered parameters:

Returned answer:

{
    "id":_identifier_of_client's_account_,
   "wallet":{
      "balance":_state_of_MG_wallet_,
      "credit":_overdraft_amount_,
      "income":_total_replenish_sum_
   }
}

All sums tranfered in advertising agency currency

Possible errors:

If transferred current token is invalid, returned error is "invalid token";

If client id is incorrect returned answer is "Invalid client id".

 

Getting financial stats of advertising agency

Transfered parameters:

Returned answer:

{
    "id":_identifier_of_user(advertising_agency)_account_,
   "balance":{
      "personal_account":_balance_on_main_wallet_,
      "bonus_account":_balance_on_bonus_wallet_,
      "clients_balance":_sum_of_cuurent_clients_balances_
   }
}

All sums tranfered in advertising agency currency.

Possible errors:

If transferred current token is invalid, returned error is "invalid token".

 

Getting data of advertising agency clients expences for a period

Transfered parameters:

Returned answer:

{
   dateStart:Period start date in format YYYY-MM-DD,
   dateEnd:Period end date in format  YYYY-MM-DD,
   clients-spent-reports:[
      {
         "id":_identifier_of_client's_account_,
         "spent":_sum_of_expences_by_directions_(goodhits +news + banners)
      },

   ]
}

All sums transfered in advertising agency currency.

If parameter clientsIds is empty, return expenses for all advertising agency clients.

Possible errors:

If the transferred current token is invalid, returned error is "invalid token";

If client id is incorrect returned answer is "Invalid client id";

Possible format errors of parameters: dates should be in the format of YYYY-MM-DD, clientsIds should be separated by commas.

 

Clients balance replenishments from advertising agency wallet

Transfered parameters:

Returned answer:

{
    "idAuth":"_identifier_of_user's_account__",
       "clientId":"_client_id_",
      "status":"success",
     "bonus\personal_account":"_accout_balance_",
   bonus or personal based on incoming parameters,
      "wallet":{
       "balance":"_client's_account_balance_",

   }
}

All sums transfered in advertising agency currency.

Possible errors:

1) If money on the specified account is not enough, the amount entered in the transferred data is larger than the specified purse, return the error "The amount of money in the account is less than what you are trying to transfer."

2) If the transferred current token is invalid, returned error is "invalid token"

3) If the client id is not in the system or curator is not this advertising agency, return error "Invalid client id"

4) If the account, client, and the amount of remittances are empty, return the error "Account (client, amount) is not specified "