投寄箱

这是我们崭新的REST API的文档页面-并不是要找到它。此API尚未准备好供公众使用。随着我们的成长,我们正在砍伐和改变很多。因此,如果您构建使用它的东西,那么很可能在以后的更新中中断。 不要说您没有被警告!

网址:

//api.meituohu.com/v2/{objecttype}/{objectnumber}/files

方法):

获取,发布,删除

回应格式:

JSON,XML

描述:

这些方法使您可以列出,上传和删除Dropbox文件。
URL中的{objecttype}可以由Dropbox文件所属的以下实体之一代替。
URL中的{objectnumber}是Dropbox文件所属实体的标识符(如下所述)。

{objecttype}{objectnumber}
行情报价编号
发票发票号码
采购采购编号
顾客客户代码
银行账户银行账户名称

因此,URL / invoice / 100 / files的GET将返回属于发票号100的Dropbox文件。

参量

名称类型描述
图标文件的图标名称。这唯一地标识了需要用来表示该文件的图像文件。
名称文件名
LastModifiedDate日期上次修改文件的日期。例如[JSONDATE]
大小字节数字文件大小(以字节为单位)
显示大小尺寸要在UI上显示的文件的大小
是否可用布尔型文件的缩小版本是否可用。目前,我们支持以下版本“jpg”, “jpeg”, “png”, “tiff”, “tif”, “gif” and “bmp”文件格式。因此,仅对于这些文件,此字段的值为‘true’
FileUri带签名的Uri会获取文件位。
缩略图带签名的Uri,它将获取文件缩小版本的文件位(如果有)。

为kashflow用户配置保管箱操作

网址: / dropbox /身份验证

GET的示例响应


"https:\/\/www.dropbox.com\/1\/oauth\/authorize?oauth_callback=https%3A%2F%2Fapi.kashflow.com%2Fv2%2Fdropbox%2Fauthentication%2Furl%3Fkashflowuserid%3D93951%26userguid%3DB40CFB55-A9D4-446F-A373-DB283EC57299&oauth_token=0oC86SFXU6GHzqaA"

返回的网址应在5分钟内使用。如果要将客户端重定向到新位置,则应在URL后面附加querystring redirecturl = {redirecturl}。

GET操作

提供对保管箱帐户的访问权限

网址: / dropbox / authentication / url?kashflowuserid = {kashflowuserid}&uid={uid}&userguid={userguid}&oauth_token = {oauthtoken}&redirecturl = {redirecturl}

GET的示例响应

Status Code: 200

如果指定了重定向URL,则在向kashflow帐户提供对Dropbox的访问后,客户端将被重定向到指定的URL。如果未指定重定向网址,则在允许kashflow帐户访问保管箱后,将返回状态码200。

GET文件列表
返回与已验证用户的特定实体对象关联的所有Dropbox文件。

网址: / {objecttype} / {objectnumber} /文件

GET 投寄箱文件的示例响应


[{
  "图标": "page_white_picture",
  "名称": "76643107_13e683ad6f.jpg",
  "大小字节": 164391,
  "显示大小": "160.5 KB",
  "LastModifiedDate": "2008-03-11 12:00:00",
  "是否可用": 真正,
  "缩略图": "https:\/\/api-content.dropbox.com\/1\/thumbnails\/sandbox\/Invoices\/4455\/76643107_13e683ad6fnw123.jpg?oauth_consumer_key=skewpon3lk0h3ft&oauth_nonce=13717885376D02A920D0E24074867CF0D752EAB7CB&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1371788537&oauth_token=4u58uefwbm4e6kr&oauth_signature=3%2FdLVsCIudp3fD2ZimlNlwatFzI%3D",
  "FileUri": "https:\/\/api-content.dropbox.com\/1\/files\/sandbox\/Invoices\/4455\/76643107_13e683ad6fnw123.jpg?oauth_consumer_key=skewpon3lk0h3ft&oauth_nonce=13717885376D02A920D0E24074867CF0D752EAB7CB&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1371788537&oauth_token=4u58uefwbm4e6kr&oauth_signature=3%2FdLVsCIudp3fD2ZimlNlwatFzI%3D"
},{
  "图标": "page_white_picture",
  "名称": "76643107_13e683ad6f.jpg",
  "大小字节": 164391,
  "显示大小": "160.5 KB",
  "LastModifiedDate": "2008-03-11 12:00:00",
  "是否可用": false,
  "缩略图": "",
  "FileUri": "https:\/\/api-content.dropbox.com\/1\/files\/sandbox\/Invoices\/4455\/76643107_13e683ad6fnw123.jpg?oauth_consumer_key=skewpon3lk0h3ft&oauth_nonce=13717885376D02A920D0E24074867CF0D752EAB7CB&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1371788537&oauth_token=4u58uefwbm4e6kr&oauth_signature=3%2FdLVsCIudp3fD2ZimlNlwatFzI%3D"
}]

单个文件的获取
返回与已验证用户的实体对象的特定文件关联的Dropbox文件信息。

网址: / {objecttype} / {objectnumber} / files / {filename}

{filename}是要获取的文件的名称。

GET 投寄箱文件列表的示例响应


{
  "图标": "page_white_picture",
  "名称": "76643107_13e683ad6f.jpg",
  "大小字节": 164391,
  "显示大小": "160.5 KB",
  "LastModifiedDate": "2008-03-11 12:00:00",
  "是否可用": 真正,
  "缩略图": "https:\/\/api-content.dropbox.com\/1\/thumbnails\/sandbox\/Invoices\/4455\/76643107_13e683ad6fnw123.jpg?oauth_consumer_key=skewpon3lk0h3ft&oauth_nonce=13717885376D02A920D0E24074867CF0D752EAB7CB&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1371788537&oauth_token=4u58uefwbm4e6kr&oauth_signature=3%2FdLVsCIudp3fD2ZimlNlwatFzI%3D",
  "FileUri": "https:\/\/api-content.dropbox.com\/1\/files\/sandbox\/Invoices\/4455\/76643107_13e683ad6fnw123.jpg?oauth_consumer_key=skewpon3lk0h3ft&oauth_nonce=13717885376D02A920D0E24074867CF0D752EAB7CB&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1371788537&oauth_token=4u58uefwbm4e6kr&oauth_signature=3%2FdLVsCIudp3fD2ZimlNlwatFzI%3D"
}

删除操作

删除具有给定实体对象的指定文件名的文件(URL中指定的类型和标识符)。

网址: / {objectType} / {objectNumber} / files / {filename}

{filename}是要删除的文件的名称。

开机自检操作

将文件上传到保管箱。

发票网址: /发票/文件
报价网址: /报价/文件
URL for 采购: /购买/文件
客户网址: /客户/文件
银行账户的网址: / bankaccounts / files

电子邮件附件的创建涉及HTTP多部分POST操作。
Example 码 snippet for posting a file is shown below.

POST的代码段


<form action="http://{domainUrl}/invoices/files" enctype="multipart/form-data" method="post">
  <input id="sessiontoken"类型="隐"名称="sessiontoken"值="{sessiontoken}" /> 
  <input id="数"类型="隐"名称="数"值="{数}" /> 
  <input class="txtBox" id="fileToUpload"类型="file"名称="file" /> 
  <input type="submit"值="Upload File" />
</form>

在这种情况下,{sessiontoken}是会话令牌,它是在成功认证之后获得的,而{number}是发票/报价/收据编号。
所选文件将被上传到保管箱。

如果有顾客
<input id=”number” type=”hidden” name=”number” value=”{number}” />
应该替换为
<input id=”code” type=”hidden” name=”code” value=”{customercode}” />

如果是银行帐户
<input id=”number” type=”hidden” name=”number” value=”{number}” />
应该替换为
<input id=”code” type=”hidden” name=”code” value=”{bankAccountName}” />

注意:应保留给定代码段中指定的字段顺序。

将PDF文件发送到Dropbox

要将报价/发票/购买的特定PDF文件上载到Dropbox。

发票网址: /发票/文件/ {number}
报价网址: / quotes / files / {number}
URL for 采购: / purchases / files / {number}

网址中的{number}将由分配给实体的唯一编号代替

注意:这是不带正文的发帖请求。

发送文件到Dropbox的示例响应


{
  "图标": "page_white_picture",
  "名称": "76643107_13e683ad6f.jpg",
  "大小字节": 164391,
  "显示大小": "160.5 KB",
  "LastModifiedDate": "2008-03-11 12:00:00",
  "是否可用": 真正,
  "缩略图": "https:\/\/api-content.dropbox.com\/1\/thumbnails\/sandbox\/Invoices\/4455\/76643107_13e683ad6fnw123.jpg?oauth_consumer_key=skewpon3lk0h3ft&oauth_nonce=13717885376D02A920D0E24074867CF0D752EAB7CB&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1371788537&oauth_token=4u58uefwbm4e6kr&oauth_signature=3%2FdLVsCIudp3fD2ZimlNlwatFzI%3D",
  "FileUri": "https:\/\/api-content.dropbox.com\/1\/files\/sandbox\/Invoices\/4455\/76643107_13e683ad6fnw123.jpg?oauth_consumer_key=skewpon3lk0h3ft&oauth_nonce=13717885376D02A920D0E24074867CF0D752EAB7CB&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1371788537&oauth_token=4u58uefwbm4e6kr&oauth_signature=3%2FdLVsCIudp3fD2ZimlNlwatFzI%3D"
}

了解KashFlow如何与您的业务和书籍一起使用