README

简介

本项目提供了一组基于 OAuth 2.0 的 Upwork API 资源，来源于 http://developers.upwork.com。

特性

以下是被支持的 API 资源

• 我的信息
• 自定义支付
• 招聘
• 职位和自由职业者档案
• 搜索职位和自由职业者
• 组织
• 消息
• 时间和财务报告
• 元数据
• 快照
• 团队
• 工作日记
• 活动

许可

版权 2018 Upwork Corporation. 版权所有。

php-upwork-oauth2 基于 Apache License, Version 2.0 许可证（以下简称“许可证”）；除非遵守许可证规定或书面同意，否则不得使用此文件。您可以在以下地址获得许可证的副本：

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则在许可证下分发的软件按“现状”分发，不提供任何明示或暗示的保证或条件。请参阅许可证以了解管理许可证下权限和限制的具体语言。

服务等级协议

此 API 的使用受以下使用条款约束：

https://developers.upwork.com/api-tos.html

应用程序集成

为了集成此库，您需要具备

• PHP >= 5.6.0
• 已安装 Composer

示例

此外，在 example 目录中提供了一个完整的示例，包括 example.php，该文件获取访问令牌并请求数据。

还包括一个 composer.json 文件，用于与 Composer 一起使用。

Composer

为了轻松地将此库集成到您的应用程序中，我们建议使用 Composer 安装依赖项。

以下是您可以使用的一个简单的 composer.json 文件示例

{
    "name": "upwork/my-oauth2-app",
    "require": {
        "upwork/php-upwork-oauth2": "dev-master"
    }
}

使用 Composer 安装

将 upwork/php-upwork-oauth2 添加到您的 composer.json 文件中，简单示例

{
    "name": "my/my-oauth-app",
    "require": {
        "upwork/php-upwork-oauth2": "v2.0.0" // note: the latest release is recommended
    }
}

运行以下命令 /usr/local/bin/composer.phar update

输出应类似于

Loading composer repositories with package information
Updating dependencies (including require-dev)
  - Installing upwork/php-upwork-oauth2 (v2.0.0)
    Downloading: 100%         

Writing lock file
Generating autoload files

重要：该库支持不同的 OAuth2 客户端，默认使用 thephpleague/oauth2-client。如果您不想使用它，或者没有安装它的可能性，您可以创建自己的包装器（检查 vendor/upwork/php-upwork-oauth2/src/Upwork/API/AuthTypes/ 了解其工作原理）。

如果有的话，将 vendor/upwork/php-upwork-oauth2/example/example.php 复制到 myapp.php

注意：如果您使用自己的包装器，请更新 myapp.php 配置部分中的 'authType' 属性，并指定处理程序名称。

打开 myapp.php 并输入您之前从 API 中心获得的 clientId、clientSecret 和 redirectUri。 请仔细阅读示例中的注释。

就是这样。以 php myapp.php 运行您的应用程序，并享受乐趣。