README

Mavenlink的项目协作套件让您可以从世界任何地方管理业务关系、共享文件和跟踪项目活动。在Mavenlink的项目工作区中，您可以协商预算和进度，跟踪时间，发送发票，通过PayPal收款，并完成工作。

Mavenlink API 提供了对Mavenlink许多功能的编程访问，包括项目、帖子、任务和时间条目。此库将成为Mavenlink REST API的完整功能PHP客户端。目前我们已实现了Mavenlink对象的创建和列表的示例用法。

REST API¶ ↑

我们已经在维基百科上提供了完整的REST API和Ruby客户端文档。

示例用法¶ ↑

require 'lib/mavenlink_api.php'

$mavenlinkApi = new MavenlinkApi('<oauth_token>');

// Get workspaces
$workspaces_json = $mavenlinkApi->getWorkspaces();
$workspaces = json_decode($workspaces_json);

// Get a specific workspace
$workspace_json = $mavenlinkApi->getWorkspace(<workspace ID>);

// Get events
$events_json = $mavenlinkApi->getEvents();

// Create a post in a workspace (Please see the {REST API and Ruby client documentation on the wiki}[https://github.com/mavenlink/mavenlink_ruby_api/wiki] for valid parameters.)
$response = $mavenlinkApi->createPostForWorkspace(<Workspace ID>, array('post[message]' => 'Test message'))

// Update a post in a workspace
$response = $mavenlinkApi->updateWorkspacePost(8, 20, array("post[message]" => "Updated message"));

// Delete a workspace post
$response = $mavenlinkApi->deleteWorkspacePost(8, 19)

// Create a story in a workspace
$response = $mavenlinkApi->createStoryForWorkspace(8, array('story[title]' => 'Test story', 'story[story_type]' => 'deliverable'));

示例脚本¶ ↑

尝试运行我们的示例

1: Edit examples/api_example.php to include your Mavenlink OAuth API Token.
2: Run
   php examples/api_example.php

   or

1: Edit examples/test.php to include your Mavenlink OAuth API Token.
2: cd into examples and Run
   php test.php

凭证¶ ↑

查找您的OAuth令牌¶ ↑

您的OAuth API令牌位于Mavenlink用户设置页面的API选项卡中。按照说明注册您的应用程序并检索您的OAuth令牌。

安全性¶ ↑

出于安全考虑，API仅通过SSL提供。此外，您应将API OAuth令牌视为类似于密码。拥有您令牌的人可以更改您的Mavenlink账户并代表您执行操作。如果您认为您的令牌已被泄露，请登录Mavenlink并从您的账户用户设置页面撤销您的OAuth令牌。

为Mavenlink PHP API库做出贡献¶ ↑

我们努力使PHP API与我们的REST API保持最新。但是，如果您发现缺少某个功能，请随时贡献它。

查看最新的master分支，以确保该功能尚未实现或错误尚未修复
查看问题跟踪器，以确保有人还没有请求它或贡献它
将项目Fork
开始一个功能/错误修复分支
提交并推送，直到你对你的贡献满意为止

mavenlink / mavenlink_php_api

维护者

详细信息