帮酷LOGO
0 0 评论
  • 显示原文与译文双语对照的内容
文章标签:API  DOC  
Documentation for the new Toggl API

  • 源代码名称:toggl_api_docs
  • 源代码网址:http://www.github.com/toggl/toggl_api_docs
  • toggl_api_docs源代码文档
  • toggl_api_docs源代码下载
  • Git URL:
    git://www.github.com/toggl/toggl_api_docs.git
  • Git Clone代码到本地:
    git clone http://www.github.com/toggl/toggl_api_docs
  • Subversion代码到本地:
    $ svn co --depth empty http://www.github.com/toggl/toggl_api_docs
    Checked out revision 1.
    $ cd repo
    $ svn up trunk
    
  • Toggl API文档

    Toggl API分为两个部分

    对于更改数据,包括跟踪时间,你需要使用 Toggl API

    如果你想获得所有工作空间用户和汇总数据的时间条目,你需要使用 only 报告 API,这将为你提供许多筛选,分组和排序选项。

    API格式

    API只接受JSON请求。 请确保在请求 header 中设置了 Content-Type: application/json。 每个请求返回一个代价为的json编码。

    每个动作的结果通过标准的HTTP响应代码进行通信。

    时间和日期使用 ISO 8601标准,更具体地说是 RFC 3339 中描述的子集。

    请注意,时间和日期存储在 UTC ( GMT ) 中,根据用户配置文件中的设置将数据设置为适当的时区。 3rd 方应用程序应确保他们正在使用正确的时间,并考虑日光保存( 在适用处)。

    对于速率限制,我们实现了一个漏桶。 当一个限制被击中时,请求将获得一个 HTTP 429响应,它是客户机睡眠/等待的任务。 在时间内,限制会改变,而且可以改变,但是一个安全的窗口会在第二次请求的时候被关闭。 限制是每个IP的api令牌应用的,这意味着同一IP中的两个用户将分别分配。

    示例请求

    这里的示例请求是使用一个名为 cURL的命令行 工具完成的。 如果你想亲自尝试请求,可以从这里下载 cURL。 它可以用于所有可能的操作系统。

    在Ubuntu安装cURL下面很容易:

    sudo apt-get install curl

    API令牌

    Toggl.com 中的每个用户都有一个API标记。 他们可以在"我的个人资料"的Toggl账户下找到它。

    帮助我们找到更好的API

    Toggl已经转移到 Github,因此你可以积极地参与帮助我们更好地实现 API。 如果你有任何请求或者发现 Bug,你可以使用Github的问题来了解。 你还可以 fork 文档,并通过改进发送请求请求

    代码示例

    Java

    python

    ruby

    Node.js

    C+ +

    • TogglDesktop有一个开源的开源平台库插件,可以在你自己的应用程序中重用。

    . NET

    Scala

    PHP

    Elixir

    3rd-聚会应用

    Perl

    R



    文章标签:API  DOC  

    Copyright © 2011 HelpLib All rights reserved.    知识分享协议 京ICP备05059198号-3  |  如果智培  |  酷兔英语