Phabricator API Go 创建task/提交文件到Phabricator

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