开发者平台

{
	"id": 8,
	"url": "https://support.kf5.com/apiv2/tickets/8.json",
	"title": "hello world",
	"description": "wonderful world",
	"type": null,
	"status": "solved",
	"priority": "low",
	"recipient": null,
	"requester_id": 738,
	"assignee_id": 733,
	"organization_id": null,
	"group_id": 165,
	"problem_id": null,
	"due_date": null,
	"created_at": "2014-06-12 17:25:40",
	"updated_at": "2014-07-04 15:04:51",
	"assigneed_at": "2014-06-15 00:00:00",
	"resolved_at": "2014-07-04 15:04:51",
	"closed_at": null,
	"source": "web",
	"collaborator_ids": [ ],
	"tags": [ "TAG测试","TAG测试1" ],
	"custom_fields": [
	 {
		"name": "field_8",
		"value": "1213"
	 },
	 {
		"name": "field_36",
		"value": "下拉菜单选项"
	 }
	],
	"satisfaction_rating": {
		"id": 16,
		"score": "Great",
		"comment": "great service!"
	}
} 

curl https://{subdomain}.kf5.com/apiv2/tickets.json \
  -v -u {email_address}:{password}

Status: 200 OK

{
	"tickets": [
		{
			"id": 1,
			"title": "您好,您有一个工单需要处理",
			...
		},
		{
			"id": 2,
			"title": "您好,您还有一个工单需要处理",
			...
		}
	]
}

curl https://{subdomain}.kf5.com/apiv2/tickets/{id}.json \
  -v -u {email_address}:{password}

Status: 200 OK

{
	"ticket": {
		"id": 1,
		"title": "admin 您好,您有一个测试工单需要处理",
		...
	}
}

curl https://{subdomain}.kf5.com/apiv2/tickets/show_many.json?ids={ids} \
 -v -u {email_address}:{password}

curl https://{subdomain}.kf5.com/apiv2/tickets.json \
  -d '{"ticket":{"title":"the title", "comment": { "content": "the content" }}}' \
  -H "Content-Type: application/json" -v -u {email_address}:{password} -X POST

Status: 201 Created
Location: https://{subdomain}.kf5.com/apiv2/tickets/{id}.json

{
  "ticket": {
    {
      "id":      123,
      "title": "the title",
      ...
    }
  }
}

 "requester": "newuser@mail.com"

 "requester": "18613210119"

"requester":{ 
	"email": "pablito@example.org",
	"phone": 18613210119,
	"name": "new user" 
}

{
  "ticket":{
    "title": "Let's create ticket",
    "comment": { "content": "what are you waiting for?" },
    "requester":{ "email": "pablito@example.org", "name": "new user"},
    "type": "problem"
  }
}

 "custom_fields": [{"name": "field_123", "value": "test"}, ...]

"comment":  { 
	"content": "with attachments", 
	"uploads":  ["00154af5872418a7792dda", ...] 
}

curl https://{subdomain}.kf5.com/apiv2/tickets/{id}.json \
  -H "Content-Type: application/json" \
  -d '{"ticket":{"status":"solved",   \
       "comment":{"public":true, "content": "Thanks, this is now solved!"}}}' \
  -v -u {email_address}:{password} -X PUT

Status: 200 OK

{
  "ticket": {
     "id":      123,
     "title": "Let's create ticket",
     "status":  "solved",
     ...
  }
}

{
  "ticket":{
    "comment": { "content":"thank you","public":"true" },
    "status": "solved"
  }
}

curl https://{subdomain}.kf5.com/apiv2/tickets/update_many.json?ids=1,2 \
  -H "Content-Type: application/json" -d "{\"ticket\":{\"status\":\"solved\"}}" \
  -v -u {email_address}:{password} -X PUT

Status: 200 OK

{
  "results": [
    {
      "id": 1,
      "success": false,
      "errors": "状态为已解决时，受理人不能为空"
    },
    {
      "id": 2,
      "success": true,
      "errors": ""
    }
  ]
}

{
  "ticket": {
    "status": "solved"
  }
}

curl https://{subdomain}.kf5.com/apiv2/tickets/{id}.json \
  -v -u {email_address}:{password} -X DELETE

Status: 200 OK

curl https://{subdomain}.kf5.com/apiv2/tickets/destroy_many.json?ids=1,2,3 \
  -v -u {email_address}:{password} -X DELETE

Status: 200 OK

Status: 200 OK

{
  "tickets": [
    {
      "id": 33,
      "status": "open",
      "title": "here is a bug",
      ...
    },
    {
      "id": 34,
      "status": "closed",
      "title": "here is another bug",
      ...
    }
  ]
}

curl https://{subdomain}.kf5.com/apiv2/tickets/{id}/collaborators.json \
  -v -u {email_address}:{password}

Status: 200

{
  "users": [
    {
      "id": 100,
      "name": "客服1号",
      ...
    },
    {
      "id": 101,
      "name": "客服2号",
      ...
    }
  ]
}

curl https://{subdomain}.kf5.com/apiv2/tickets/{id}/incidents.json \
  -v -u {email_address}:{password}

Status: 200 OK

{
  "tickets": [
    {
      "id":          33,
      "subject":     "service 503",
      "status":      "open",
      ...
    },
    {
      "id":          34,
      "subject":     "503 service",
      "status":      "pending",
      ...
    },
  ]
}

curl https://{subdomain}.kf5.com/apiv2/tickets/problems.json \
  -v -u {email_address}:{password}

Status: 200 OK

{
  "tickets": [
    {
      "id":          32,
      "subject":     "503 service",
      "status":      "open",
      ...
    },
    {
      "id":          90,
      "subject":     "here is a bug",
      "status":      "pending",
      ...
    },
  ]
}