Go Phabricator API 代碼/程序創建task/提交文件到Phabricator
Creat Task or upload file to phabricator with code in go
之前寫一個服務往phabricator 上提交task，上傳文件；當時查了好久，發現官方文檔很不明確，而網上又幾乎沒有資料，所以把最終寫的整理一下給需要的做一個參考。
Several days ago，I have writing a service to submit tasks or upload files to the phabricator.At that time , search for a long time, found that the official document is not very clear, and almost no information on the Internet, so share something about this.
upload file/image or other info to phabricator by program in Go
Go語言，通過程序往phabricator上傳文件/圖片，新建task.
最終是要在phabricator上提交一個task，func3，通過調用調用func1，上傳一個file，通過func2，獲取這個file的id。在func3中創建task的時候，可以通過“F【 + id】”的格式引用這個文件或者圖片。
The final target is to submit a task to the phabricator. Func3, by calling func1 upload a file, through func2, get the id of this file. In the func3 create a task, you can use "F [+ id]" format to quoted the file(or picture).
上傳文件
upload file
注意 phabricator接收base64數據，而且不要開頭的格式聲明部分，即只要“，”后邊的。
Pay attention，phabricator receive a data of base64 format,and deny the chars befor ",".
//1,文件上傳：file.upload ，拿回來phid;在task里可以通過phid引用。
//1,upload file. api:file.upload. Get back the phid of this file which can be quoted in a task page。
func UploadFile(imageBase64List [imageMaxNum]string) ([]string, error) {
phidList := make([]string, 0)
urlStr := "https://ph.com/api/file.upload"
for _, imageBase64 := range imageBase64List {
if imageBase64 == "" {
continue
}
//截取“，”后邊的字符串,
//Get chars after ","
imageData := strings.Split(imageBase64, ",")
if len(imageData) != 2 || !utils.JudgeBase64(imageData[1]) {
return phidList, errors.New("圖片數據格式錯誤")
}
form := url.Values{}
form.Add("data_base64", imageData[1])
req, _ := http.NewRequest("POST", urlStr, bytes.NewBufferString(form.Encode()))
q := req.URL.Query()
q.Set("api.token", common.Config.ApiToken)
req.URL.RawQuery = q.Encode()
req.Header.Add("content-type", "application/x-www-form-urlencoded")
resp, err := http.DefaultClient.Do(req)
if err != nil {
return phidList, err
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
return phidList, err
}
//解析body，並且添加到切片
//Unmarshal body and add to slice
var uploadResp UploadFileResp
if err := json.Unmarshal(body, &uploadResp); err != nil {
err := errors.New("文件上傳時發生未知錯誤:" + err.Error())
return phidList, err
}
phidList = append(phidList, uploadResp.Result)
}
return phidList, nil
}
根據文件的phid獲取id
get the id of file by phid
// 2,獲取文件/圖片id：file.info 拿回來一個file id
// 2,get the id of file/image though file.info .
func getImageId(phidList []string) (imageIdlist []string, err error) {
imageIdList := make([]string, 0)
urlStr := "https://ph.com/api/file.info"
for _, phid := range phidList {
if phid == "" {
continue
}
form := url.Values{}
form.Add("phid", phid)
req, _ := http.NewRequest("POST", urlStr, bytes.NewBufferString(form.Encode()))
req.Header.Add("content-type", "application/x-www-form-urlencoded")
q := req.URL.Query()
q.Set("api.token", common.Config.ApiToken)
req.URL.RawQuery = q.Encode()
resp, err := http.DefaultClient.Do(req)
if err != nil {
return imageIdList, err
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
return imageIdList, err
}
var findImageResp FindImageIdResp
if err := json.Unmarshal(body, &findImageResp); err != nil {
err := errors.New("獲取文件信息時發生未知錯誤" + err.Error())
return imageIdList, err
}
imageIdList = append(imageIdList, findImageResp.Result.ObjectName)
}
return imageIdList, nil
}
入口函數
entrance func
conduit api 測試頁面參數示例
conduit pages api test parameters example
[ { "type":"title", "value":"Test API in conduit" },
{ "type":"view", "value":"users" },
{ "type":"projects.add", "value":["bug_管理","生 產環境"] },
{ "type":"description", "value":"Nothing , need not to be concerned. " },
{ "type":"priority", "value":"low"},
{ "type":"custom.mq.customer_id_and_name","value":"coustomId and name"}
]
接收參數，並調用fun1、fun2，最終提交task。
Get parameters ，call func1、func2，submit a task at last。
// 3,接收bug信息,上傳文件/圖片，獲取文件id，提交bug信息，返回提示信息。
// 3,receive the infomation from pages,get the id of file/image ,submit info and sendback tips.
func ReceiptBugInfo(w http.ResponseWriter, r *http.Request) {
var reqInfo ReceiptBugInfoRequest
if err := utils.BindJSON(r, &reqInfo); err != nil {
render.BindError(w, r, err)
return
}
desc := reqInfo.Desc + "\n\n終端信息：" + reqInfo.EndPointInfo + "\nbug提交位置參考路徑：" + reqInfo.BugPageUrl
customIdAndName := "用戶名：" + reqInfo.CustomerName + " 用戶ID：" + reqInfo.CustomerId + " 租戶ID" + reqInfo.TenantId
desc += "\n" + customIdAndName + "\n"
//檢查，不為空則調用getImgId，並拼入desc
if reqInfo.ImagesData[0] != "" {
phidList, err := UploadFile(reqInfo.ImagesData)
if err != nil {
render.InternalError(w, r, err)
}
imageIdSlice, err := getImageId(phidList)
if err != nil {
render.InternalError(w, r, err)
}
for _, images := range imageIdSlice {
if images == "" {
break
}
desc += "\nbug截圖：\n{" + images + "}"
}
}
urlStr := "https://ph.com/api/maniphest.edit"
form := url.Values{}
form.Add("transactions[0][type]", "title")
form.Add("transactions[0][value]", reqInfo.Title)
form.Add("transactions[1][type]", "description")
form.Add("transactions[1][value]", desc)
form.Add("transactions[2][type]", "priority")
form.Add("transactions[2][value]", reqInfo.Priority)
form.Add("transactions[3][type]", "projects.add")
form.Add("transactions[3][value][0]", "bug_管理")
form.Add("transactions[3][value][1]", "生產環境")
form.Add("transactions[4][type]", "space")
form.Add("transactions[4][value]", "PHID-SPCE-cnulhg6i3r4m5evgb4wc")
req, _ := http.NewRequest("POST", urlStr, bytes.NewBufferString(form.Encode()))
req.Header.Add("content-type", "application/x-www-form-urlencoded")
q := req.URL.Query()
q.Set("api.token", common.Config.ApiToken)
req.URL.RawQuery = q.Encode()
resp, err := http.DefaultClient.Do(req)
if err != nil {
render.InternalNetError(w, r, err)
}
defer resp.Body.Close()
//解析這個body，error不為空則報錯,圖片上傳.
//Unmarshal body,if error is not nil,panic.else upload file/image.
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
render.InternalError(w, r, err)
return
}
var bugInfoResp BugInfoUploadResp
if err := json.Unmarshal(body, &bugInfoResp); err != nil {
error := errors.New("解析反饋信息時發生未知錯誤" + err.Error())
render.InternalError(w, r, error)
return
}
if bugInfoResp.ErrorCode != "" {
err := errors.New("提交信息時發生未知錯誤" + bugInfoResp.ErrorInfo)
render.InternalError(w, r, err)
return
}
render.Success(w, r)
}
結構體定義如下
definition struct as below
type BugInfoUploadResp struct {
Result BugRespResult `json:"result" binding:"omitempty`
ErrorCode string `json:"error_code" binding:"omitempty`
ErrorInfo string `json:"error_info" binding:"omitempty`
}
type BugRespResult struct {
Object BugRespObject `json:"object" binding:"omitempty`
Transactions Phids `json:"transactions" binding:"omitempty`
}
type BugRespObject struct {
Id int `json:"id" binding:"omitempty`
Phid string `json:"phid" binding:"omitempty`
}
type Phids []Phid
type Phid struct {
Phid string `json:"phid" binding:"omitempty`
}
type UploadFileResp struct {
Result string `json:"result" binding:"omitempty`
ErrorCode string `json:"error_code" binding:"omitempty`
ErrorInfo string `json:"error_info" binding:"omitempty`
}
type FindImageIdResp struct {
Result ImgIdRespInfo `json:"result" binding:"omitempty`
ErrorCode string `json:"error_code" binding:"omitempty`
ErrorInfo string `json:"error_info" binding:"omitempty`
}
type ImgIdRespInfo struct {
Id string `json:"id" binding:"omitempty"`
Phid string `json:"phid" binding:"omitempty"`
ObjectName string `json:"objectName" binding:"omitempty"`
Name string `json:"name" binding:"omitempty"`
MimeType string `json:"mimeType" binding:"omitempty"`
ByteSize string `json:"byteSize" binding:"omitempty"`
AuthorPHID string `json:"authorPHID" binding:"omitempty"`
DateCreated string `json:"dateCreated" binding:"omitempty"`
DateModified string `json:"dateModified" binding:"omitempty"`
Uri string `json:"uri" binding:"omitempty"`
}
type ReceiptBugInfoRequest struct {
TenantId string `json:"tenantId" binding:"required"`
CustomerName string `json:"customerName" binding:"required"`
CustomerId string `json:"customerId" binding:"required"`
Desc string `json:"desc" binding:"required"`
Title string `json:"title" binding:"required"`
Priority string `json:"priority" binding:"required"`
EndPointInfo string `json:"endPointInfo" binding:"required"`
BugPageUrl string `json:"bugPageUrl" binding:"omitempty`
ImagesData ImageList `json:"imageData" binding:"omitempty"`
}
type ImageList [imageMaxNum]string
//反饋，圖片最大支持數目。
//feedback,the max number of image
const imageMaxNum = 10
轉載注明出處----名白
http://www.cnblogs.com/mingbai/p/GoPhabricator.html