Ticket akışları

Önce board'u keşfedin

bash

curl https://api.stoneity.com/public/v1/boards -H "Authorization: Bearer $KEY"
curl https://api.stoneity.com/public/v1/boards/65fef78fa23b4d12ab34cd56 -H "Authorization: Bearer $KEY"

Board yanıtı her alanı (fields[].id, type, isRequired, açılır listeler için options[]) ve her durumu (states[].id, name, isFirst, isLast) listeler. Kayıt çağrılarında bu id'leri kullanın.

Oluşturma

POST /tickets için boardId ve subject zorunludur. İsteğe bağlı: description, priority, requesterUserId ya da requesterEmail, assigneeUserId, assigneeGroupId ve özel alanlar için fields[]. Board'un zorunlu alanları gönderilmelidir; aksi halde alan adıyla 400 döner.

Okuma

GET /tickets/{id} kayıt id'sini ya da kayıt numarasını (ör. INC-1042) kabul eder.
GET /tickets?boardId=… şu filtreleri destekler: stateId, assigneeUserId, requesterUserId, createdSince, createdUntil (ISO 8601), q ve order=asc|desc.

Güncelleme

İşlem	Uç
Özel alanları değiştir	`PATCH /tickets/{id}`, `fields[]`
Durum değiştir	`POST /tickets/{id}/state`, `stateId` (board geçiş kuralları ve onaylar uygulanır)
Ata	`POST /tickets/{id}/assignee`, `userId` ve/veya `groupId`; ikisi de boşsa atama kaldırılır
Yorum	`POST /tickets/{id}/comments`, `body` ve `isInternal`
Dosya ekle	`POST /tickets/{id}/attachments`, `multipart/form-data` (`file`, isteğe bağlı `fieldId`, `isInternal`)
İndir	`GET /tickets/{id}/attachments/{key}`

Her değişiklik güncel kayıt temsilini döner.

Kayıt temsili

json

{
  "id": "65fef78fa23b4d12ab34cd56",
  "number": "INC-1042",
  "boardId": "…",
  "subject": "VPN erişim sorunu",
  "description": "…",
  "state": { "id": "…", "name": "Açık", "group": "Open", "isFirst": true, "isLast": false },
  "assignee": { "userId": 17, "groupId": null },
  "requester": { "userId": null, "email": "ayse@example.com" },
  "priority": "High",
  "channel": "api",
  "createdBy": 418,
  "createdAt": "2026-09-07T12:00:00Z",
  "updatedAt": "2026-09-07T12:05:00Z",
  "resolvedAt": null,
  "isWaitingApproval": false,
  "commentCount": 1,
  "attachmentCount": 0,
  "fields": [ { "fieldId": "…", "name": "Kaynak sistem", "type": "Text", "value": "Magaza" } ]
}

Ticket akışları ​

Önce board'u keşfedin ​

Oluşturma ​

Okuma ​