# Get Upload File Link

<a href="https://developers.weixin.qq.com/初始值 target="_blank" class="api-explorer" > Debugging tools

Interface should be called on the server side, seeHattori API。

# Interface Dxplaination

# Interface name

getUploadFileLink

# Functional description

Through this interface can get the link to upload the file, if you encounter problems in the process, you canOpen Platform Service Provider ZonePosting exchanges.

# Calling mode

# HTTPS call


POST https://api.weixin.qq.com/componenttcb/uploadfile?access_token=ACCESS_TOKEN

# Request parameters

attribute	type	Required	Introductions
access_Token	string	yes	Interface invokes the certificate, which is URL Parameters, non Body Parameters. usecomponent_access_Token
env	string	yes	Cloud Environment ID
path	string	yes	Upload path

# Return parameters

attribute	type	Introductions
errcode	number	Error code
errmsg	string	Error message
url	string	Upload url
Token	string	Token
authorization	string	authorization
file_id	string	File ID

# Other Notes

# Upload Link Usage Instructions

After the user gets the return data, they need to assemble a HTTP POST Request, in which url For the return package's url Field, Body Part of the format is multipart/Form-data, as follows:

key	value	Introductions
key	this/is/a/example/file.path	In the request packet path field
Signature	q-sign-algorithm=sha1&q-ak=AKID9...	Returns the data's authorization field
x-cos-security-token	Cukha70zkXIBqkh1Oh...	Returns the data's Token field
x-cos-meta-fileid	HDze32/qZENCwWi5...	Returns the data's cos_file_id field
file	Document Contents	Binary contents of a file

# Call Example

Example Dxplaination: HTTPS requests

# Sample Request Data


{
	"env": "test2-4a89da",
	"path": "this/is/a/example/file.path"
}

# Return Data Example


{
    "errcode": 0,
    "errmsg": "ok",
    "url": "https://cos.ap-shanghai.myqcloud.com/7465-test2-4a89da-1258717764/testupload",
    "token": "Cukha70zkXIBqkh1OhUIFqjUmXLXeSWq7dff61099221bb270522b8e0cf21d72e0aWCfGXEIDT5bKVJgykFFr9_MeQ-ExrsZ8oiFdMwyYag8h0r-EJq_EaO94KzksxH6bAeb4Y7SwZjJqoy_4g1Na797F1IEG9Dnstm_rz02AgaP5HbJwt1P-XHT4Xjw_lafla079gtQKAP-EPbE5Tc8BRXIm32esjGDDDuDyml7IJqbsPolYZ4-CHQsisdx488loGAN4f7YRMkrrP1Pgi5XOm0-iG5HbWd3tHtuE2pzsGkTobO_fyz2PfSPaeUt_735ll38yIWpAFESAsZnBj2DcRSPBT2FJ_s5mOZACS53q6-tWXPO0AR3-EhOCQpiDKsldVsCxz00Uwhgm1T6Ozw777fJEFkUIngUdZ5yajy3LA84Mpfu6CLkFjfiBtz3wpmcCQxhijo_CrVHkmaMc2JBQ " ,
    "authorization": "q-sign-algorithm=sha1&q-ak=AKID98EDB528Sfqerp0Z_7l23we-u4Avrx04te9VvlzGihMTseysMgu7iSdh_hxEnoAy&q-sign-time=15573071301557308030&q-key-time=15573071301557308030&q-header-list=&q-url-param-list=&q-signature=ac95227b67a04157bb5e49b435c6ac3ce88e03f2",
    "file_id": "cloud://test2-4a89da.7465-test2-4a89da-1258717764/testupload",
    "cos_file_id": "HDze32/qZENCwWi5N5akgoXSv3U8DsccKaqCxTMGs0zFgvlD28j484/VYFPJ1l2QDh0Qy8wNbQCpxs5zEsLJln1lIY9RGYn1LzRQQQYFQm Xwvw6S4YEZN1AIwY906mwIBgiI3gKGkU2K1 1ZEnEYEM4Uh/C1JxB4Q=="
}

# Error code

Error code	Error code	Solutions
0	ok	ok
-1	system error	The system is busy, please wait for the developer to try again
初始值	system error	System error
40014	invalid access_Token	Illegal access_Token Please take the developer seriously. access_Token Of the validity (such as whether it is expired), or to see if you are working for the appropriate Official Account message template Call interface
40097	invalid args	Parameter error
40101	missing parameter	Missing required parameters
41001	access_Token missing	lack access_Token parameter
43002	require POST method	Need POST request
44002	empty post data	POST The packet is empty.
47001	data format error	analysis JSON/XML Content errorpost Missing parameters in the dataCheck for corrections and try again.
85088	no qbase privilege	The app is not open for cloud development