chromatic/orange-dam-php

Orange Dam PHP API客户端

v1.3.0 2024-06-05 14:04 UTC

README

Orange DAM API 允许开发者扩展其Orange数字资产管理平台的功能。通过调用其API端点,可以操作和集成Orange DAM网站与CMS或其他软件/工作流程。

此库支持 Orange DAM Drupal模块。有关与其他CMS平台的集成,请参阅 未来开发

此库可实现以下功能

  • 身份验证
  • 搜索内容。
  • 媒体检索/导入。
  • 访问关键词数据/活动。
  • 检索媒体标题。
  • 列出已删除的对象。

未来开发

Orange DAM API功能丰富,此库仅触及了其可用功能的表面。关于此库和/或使用它的工具下一步可能的发展方向包括以下想法

  • WordPress插件。
  • 允许将内容上传到Orange DAM。
  • 访问文件元数据。
  • 文档支持。
  • 创建文档之间的链接。
  • 与Figma资产浏览器的集成。
  • 与Adobe Lightroom的集成。
  • 与Adobe InDesign的集成。
  • PDF转换。
  • 从音频内容中提取波形。

注意: 此库及其关联的模块为与Orange DAM进行自定义集成提供了基础。需要自定义开发工作来创建应用程序中的数据模型、映射数据以及/或集成此模块提供的事件。

如需通过赞助进一步开发此库或其关联模块,或查询自定义集成,请联系Chromatic

安装

composer require "chromatic/orange-dam-php"

用法

use Chromatic\OrangeDam\Factory as OrangeDamApi;

// Create client instance.
$api = new OrangeDamApi([
    'base_path' => 'https://orange-dam-api-server-example.com',
    'query_string' => 'SESSION=XXX',
  ],
  NULL,
  ['http_errors' => FALSE]
);

// Authenticate with OAuth2.0.
$tokens = $api->oAuth2()->getTokensByCode(
  'CLIENT_ID_XXX',
  'CLIENT_SECRET_XXX',
);
$api->getClient()->setOauth2Token($tokens->access_token);

// Make a search request with given parameters.
$params = [
  'query' => 'SystemIdentifier:XXXX',
  'fields' => 'Title,SystemIdentifier,Caption',
  'format' => 'json',
];
$response = $api->search()->search($params);
$content = $response->getData();