This SDK makes using the Getty Images Connect API easy. It handles credential management, makes HTTP requests and is written with a fluent style in mind. The Connect API Documentation is located on Github.

This Solution contains two projects:

• ConnectSdk - the SDK library.
• ConnectSdk.OnlineTests - tests for the SDK library.

The Connect team at Getty Images uses Behavior Driven Development (BDD). We think it's a great way to develop software and want to spread the word. The test project contains scenarios written in the Gherkin language which are bound to code using SpecFlow.

• You have Visual Studio 2013 - this solution should work with 2012, but it has not been tested.
• You have Git installed
  • Git for Windows
  • If you are using Cygwin, use the Cygwin Package Installer to install Git
• You have the SpecFlow extension installed in Visual Studio

The Git repository contains a submodule which requires some special handling to get setup properly. This is because we share our scenario files across all our SDKs.

Open a console window (Command Prompt, PowerShell or Bash) and issue the following commands to clone the Git repository:

git clone [email protected]:gettyimages/connect_sdk_csharp.git
pushd connect_sdk_csharp
git submodule update --init

.\build.cmd

./build.sh

If you just want to start using the SDK, jump down to Using the Nuget Package

The tests expect credentials to be stored in environment variables.

• ConnectSDK_ApiKey: API key assigned when you registered
• ConnectSDK_ApiSecret: API secret assigned when you registered
• ConnectSDK_UserName: a Getty Images user. Create one at the Getty Images website.
• ConnectSDK_UserPassword: Getty Images user's password

Note: If you don't have user account credentials, some of the tests will fail. That's OK!

Once this is complete, you can open the solution in Visual Studio:

1. Open the ConnectSdk.sln file.
2. Build the solution.
3. Tests can be run using:
   • ReSharper Unit Test Explorer
   • NUnit - You may need to install the NUnit Test Adapter

The SDK will be published to the public Nuget package repository soon. Keep an eye out for it! When you run the build from the command line, a Nuget package is built. You can reference this package from your project.

Add a new package source in Visual Studio, pointing to the directory you cloned to:

Open the package manager and add the package to your project:

The SDK currently supports:

• Searching for images
• Getting image metadata
• Creating download URLs

The SDK supports async operations, however it can also be used synchonously, such as when running in a console application:

var connect = ConnectSdk.GetConnectSdkWithClientCredentials("my_api_key", "my_api_secret");
var searchResult = connect.Search()
    .Images()
    .Editorial()
    .WithEditorialSegment(EditorialSegment.News)
    .WithPhrase("all vocabulary")
    .WithSortOrder("newest")
    .ExecuteAsync()
    .Result;

foreach (var image in searchResult.images)
{
    Console.WriteLine("Title: {0} \r\nId: {1}", image.title, image.id);
}

Results are returned as dynamic. Visit the Connect API Interactive Documentation to learn more about available parameters and to see what the response object look like.