Security & Authentication

Abstract

All DataX API calls must take place over HTTPS. Partner’s client implementations must validate Yahoo Ad Tech’s DataX server certificate prior to interacting with it.

Note

DataX does not support any clear-text API calls.

Get API Keys

Follow these steps to obtain your API Keys:

1. Log into developer.yahoo.com

2. Create a new project at: https://developer.yahoo.com/apps/create/

   • Application Name: <a name>

   • Application Type: Web-based

   • Description: <a description>

   • Home Page URL: <though not relevant in this context, you can specify your homepage url.>

   • Access Scopes: This app will only access public APIs, Web Services

   • Premium API services: <leave unchecked>

3. Save the following information from the next screen:

   • Application ID - displayed below your Application Name (an 8 character string, e.g., Qe78Z23f).

   • Consumer Key

   • Consumer Secret (keep secret!)

   You can change your consumer Secret at any time by visiting https://developer.yahoo.com with the login credentials you used to create this Application. Once you are back at the Application screen that displays your Consumer Key & Consumer Secret, click “Save and Change Consumer Key” (toggle a permission to activate the button), to generate a new Consumer Secret.

4. Be sure to work with your Yahoo Ad Tech contact to onboard the above Application ID on DataX as you (your partnership with Yahoo as a data provider). Internally, this Application ID will be used to identify you as a certain data provider/partner.

5. Use your Consumer key and Consumer Secret in every call made to https://datax.yahooapis.com, via an Oauth library. Refer to Appendix A for examples.