README

Olivier Sirven olivier@fotolia.com Fotolia.com

介绍

Fotolia的行业领先API允许开发者和企业快速将其庞大的图像数据库集成到工作流程和商业模式中。

无论您是在开发拥有数百万张照片的应用程序，还是将库存摄影库集成到您的业务中以提高客户满意度，Fotolia强大的API都是关键。但技术卓越只是公式的一部分——我们的业务发展团队将与您合作，确定最佳方式以最大化效果。

Fotolia的API系列

合作伙伴API

我们的合作伙伴API允许您将免版税的图像搜索嵌入到您的网站中。

• 您的客户可以在不离开您网站的情况下搜索整个Fotolia库以找到图像。
• 找到完美的图像后，您的客户会点击链接到我们这里购买。
• 由于我们的联盟计划也集成到这个API中，我们将自动为您产生的所有收入付费。

了解更多信息

企业API

我们的企业API是为按需业务生产的定制品和产品而设计的，包括网站模板和印刷材料。

• 您的客户将能够直接在您的应用程序或基于Web的工具中获得高分辨率图像。
• 提供批发价格。
• 您还可以使用此API将Fotolia嵌入到您的内部网站或应用程序中，以加快搜索和下载速度。

了解更多信息

分销商API

我们的分销商API允许您以您的品牌名称向客户销售Fotolia的图像。

• 访问Fotolia的整个微股图像库，提供完整的搜索和下载功能。
• 这是一个完整的白标解决方案，可在全球选定市场提供。

了解更多信息

本软件包的内容

此软件包包含PHP、python和java的API完整实现。每个都提供了一个示例文件来展示如何使用它。

PHP

要求

• PHP >= 5.2
• PHP cURL扩展

示例用法

#!/usr/bin/env php
getSearchResults(
    array(
        'words' => 'car',
        'language_id' => Fotolia_Api::LANGUAGE_ID_EN_US,
        'limit' => 1,
    ));

printf("Found %d results", $results['nb_results']);

foreach ($results as $key => $value) {
    // iterating only over numeric keys and silently skip other keys
    if (is_numeric($key)) {
        printf("matching media ID: %d", $value['id']);
    }
}

// loggin in and retrieving user data
$api->loginUser('your_login', 'your_password');
print_r($api->getUserData());

// purchasing and downloading a file
$dl_data = $api->getMedia(35957426, 'XS');
$api->downloadMedia($dl_data['url'], '/tmp/' . $dl_data['name']);

Python

要求

• Python >= 2.7
• pycurl扩展

示例用法

#!/usr/bin/env python

import fotolia_api

api = fotolia_api.FotoliaApi('your_api_key')

# searching for files
results = api.get_search_results({'words': 'car', 'language_id': fotolia_api.LANGUAGE_ID_EN_US, 'limit': 1})
print "Found %d results" % results['nb_results']

for key, value in results.items():
    try:
        int(key)
        print "matching media ID: %d" % value['id']
    except ValueError:
        # iterating only over numeric keys and silently skip other keys
        pass

# loggin in and retrieving user data
api.login_user('your_login', 'your_password')
print api.get_user_data()

# purchasing and downloading a file
dl_data = api.get_media(35957426, 'XS')
api.download_media(dl_data['url'], '/tmp/' + str(dl_data['name']))

Java

要求

• apache common HTTP客户端
• json简单
• java JDK >= 6.26

提供了一个简单的Makefile来帮助使用它。它支持以下命令

build:: 构建整个软件包

jar:: 创建JAR文件以便于包含

clean:: 清理构建文件

example:: 构建示例程序

示例用法

import org.webservice.fotolia.*;
import org.json.simple.JSONObject;

public class example
{
    public static void main(String[] args)
    {
        FotoliaApi client = new FotoliaApi("your_api_key");

        // fetching a media data
        System.out.println(client.getMediaData(18136053));

        // searching files
        FotoliaSearchQuery query = new FotoliaSearchQuery();
        query.setWords("car").setLanguageId(FotoliaApi.LANGUAGE_ID_EN_US).setLimit(1);
        System.out.println(client.getSearchResults(query));

        // buying and downloading a file
        try {
            client.loginUser("your_login", "your_password");
            JSONObject res = client.getMedia(35957426, "XS");
            client.downloadMedia((String) res.get("url"), "/tmp/" + (String) res.get("name"));
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

信息

电子邮件: api@fotolia.com

Google组

在线文档