FAQ

Please take our Survey so we can better serve you.

1) Do you have a forum where I can talk to other NetDNA Developers?

Yes our tag on StackOverflow is netdna-api: http://stackoverflow.com/questions/tagged/netdna-api

2) What time zone are reports returned in? What is the time zone filed in account for (give the actual name)?

Reports are in Greenwich Mean Time (GMT).  The purpose of this is so that billing and reports are done in the same time zone and all the edge server logs are sync'd to GMT.  In previous versions of the API we did translations of time zones and we have found it easier to develop using the standardized GMT time zone.  The time zone in the Account setting is used solely for customer service purposes and not to adjust the time zone of reports.

3) Where is your search engine?

Top right hand corner.  Please give us feedback.

4) Where can I find a OAuth library?

Google Code has libraries available for:

5) What OAuth protocol version are you supporting?

OAuth 1.0a

6) What kind of sample code is available?

We have prepared sample code for PHP, PERL and Python available.  Make sure to download an OAuth library.

7) How do I whitelist my server/workstations IP?

If you try to make any API calls with out whitelisting your IP you will see the following:

Exception: ('401', {'status': '401', ...'{"code":401,"error":{"message":"Your IP 74.125.136.100 is not whitelisted","type":"RWS\\\\Exception"}}')

To whitelist your IP please go here: /developer/api/whitelist/
Selection

9) What are the different variables and where do I find my info (the {} info)

{companyalias} - The company name that you used when creating your account. This can be found by viewing the account > settings page in your control panel.

{zone_type} - The type of zone that you are calling the operation on. This can be either "pull", "push", "vod", or "live" (In certain cases only a subset of these types are valid)

{format} - The format you would like to receive the response in. This can be either "json" or "xml"

{id} - the primary key id for the item being pulled, currently limited to users and zones. If you don't know which Id you want to operate on, you can get a list of users/zones and their ids by calling the corresponding GET function without passing an id.

{user_id} - The id for the particular user you want to operate on. A list of users and their id's can be found by calling GET on /users.{format}

{zone_id} - The id for the particular zone you want to operate on. A list of zones and their id's can be found by calling GET on /zones.{format}

{customdomain_id} - The id for the particular custom domain you want to operate on. A list of custom domains and their id's can be found by calling a GET on /zones/{zone_type}/{id}/customdomains.{format}

{report_type} - The way in which report data gets segmented. This can be either "hourly", "daily", or "monthly"

{node_id} - The id for the particular PoP you want to retrieve data from. Please check the Node Id Table to get the id of your desired location.

What OAuth version does the API use?

OAuth 1.0a. Use a maintained client library.

What time zone are reports in?

Account time zone in the control panel; reports follow that setting.

How do I whitelist my IP?

Add the workstation or server IP in the account security settings.