API Queries - Edit Account
The edit_account function edits an existing parking service account in your Above.com account. Additional parameters are required for this function.
Additional Parameters
- account_id - The ID of the parking service account to edit. A list of parking services accounts in your Above.com account and their IDs can be retrieved using the List Accounts API function. (Required)
- acc_username - The username for your parking service account. (Required)
- acc_password - The password for your parking service account. (Required)
- enabled - Enable this parking service account for use with the Auto Optimizer. Accepted values are "0" (disabled) and "1" (enabled). (Optional)
- download - Whether or not to download statistics for this parking service account. This is automatically enabled when the account is enabled. Accepted values are "0" (disable downloading statistics) and "1" (enabled downloading statistics). (Optional)
Account Redirection Parameters
Note: Only one option can be set when editing a parking service.
- default - The default redirection method for this parking service. This parameter is used by default unless redirect_url, ip or cname are used. Accepted values are "1" (enabled). (Optional)
- ip - The custom IP address provided by the parking service to be used for your account redirect. (Optional)
- cname - The custom cname provided by the parking service to be used for your account redirect. (Optional)
Note: Parking service DomainApps (park_id=3) has an additional redirection option redirect_url.
Service-Specific Parameters
Some services have required and optional additional parameters:
SEDO (park_id = 1)
- sdo_signkey - SEDO sign key for SEDO API access. (Optional)
- sdo_partnerid - SEDO partner id for SEDO API access. (Optional)
- sdo_currency - Currency for API, either USD or EURO. (Required if sdo_partnerid or sdo_signkey is used)
Note: Standard SEDO accounts (not SEDO Pro) have limited access to statistics, and need API access for retrieving historical statistics.
Bodis (park_id = 25)
- bod_apikey - API Key provided by Bodis. (Optional)
Skenzo (park_id = 17)
- skz_customerid - API Key provided by Skenzo. (Optional)
- skz_guid - Customer GUID provided by Skenzo. (Optional)
RookMedia (park_id = 35)
- rmg_guid - Customer GUID provided by RookMedia. (Optional)
DomainSponsor (park_id = 2)
- ds_guid - Customer GUID provided by DomainSponsor. (Optional)
ParkingCrew (park_id = 38)
- pkc_api_key - API Key provided by ParkingCrew. (Required)
DomainAdvertising (park_id = 31)
- domadv_key - API Key provided by DomainAdvertising. (Optional)
- domadv_guid - Customer GUID provided by DomainAdvertising. (Optional)
DomainApps (park_id = 3)
- dap_apikey - API Key provided by DomainApps. (Required)
- redirect_url - The redirect URL for your parking service account. Use the $D variable where the domain needs to be inserted. (Optional)
Voodoo (park_id = 43)
- voodoo_id - Customer ID provided by Voodoo. (Optional)
- voodoo_key - API Key provided by Voodoo. (Optional)
Note: Make sure to URL encode all values.
Example query and response:
In this example, we will change the redirect URL to "http://www.searchnut.com/?domain=$D " (redirect_url=http%3A%2F%2Fwww.searchnut.com%2F%3Fdomain%3D%24D%20) for account ID 1234 (account_id=1234).
Example query:
https://www.above.com/api.php?username=user&password=pass&api_key=key&mode=
edit_account&account_id=1234&redirect_url=http%3A%2F%2Fwww.searchnut.com%2F%3Fdomain%3D%24D%20
Response:
<results> <result account_id="1234" status="Updated" /> </results>
Error Responses:
Possible error responses for this function are:
- 414 - park_id is required for add_account
- 421 - acc_username/acc_password is required for add_account
- 422 - Please enter valid currency for SEDO using signkey for API access
- 425 - Please enter API key
- 426 - API key may only contain letters from A to F, and numbers, and must be 30 characters in length
- 427 - Partner ID must be a number
- 500 - Account addition failed: NOTICE: (reason)
- General errors, such as 200 - Internal Error or 300 - Username or password invalid.