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