Ana içeriğe atla
PATCH

Ne yapar?

Yalnız gönderilen izinli alanları günceller. Gövde boş olamaz; title gönderilirse boş/null olamaz. İlişkiler firma kapsamında doğrulanır; bulunmayan kayıt 404. Değişiklikler kayıt geçmişine eklenir.

Ön koşullar ve izin

Etkin API anahtarı ve muhasip:todo:write izni gerekir. İlişkili kayıtlar aynı firmaya ait olmalıdır. Erişim ayarları için kimlik ve izinler rehberini inceleyin. İstek ve cevap şemalarını indirin.

İstek örnekleri

Örnekler temsilîdir. Kimlikleri, belge tarihlerini ve iş verisini kendi yetkili kayıtlarınızla değiştirin. Node.js örnekleri Node.js 20 veya üzeri içindir; PHP örnekleri cURL uzantısını kullanır. Hiçbiri otomatik tekrar yapmaz.

Cevabı değerlendirin

Önce HTTP durumunu, ardından bu kaynağın status ve sonuç alanlarını değerlendirin. Bütün uçlar aynı sonuç zarfını veya oluşturma için 201 kodunu kullanmaz. Temsilî başarılı cevap; gerçek hizmet çağrısından alınmamıştır:

Hata durumunda

Ağ kesintisi, zaman aşımı veya JSON olmayan cevap mali etkinin oluşmadığını kanıtlamaz. Ham istek/cevapları genel loglara yazmayın. Hata yönetimi

Sonraki adım

İlgili liste veya detay çağrısıyla kaydı ve bağlı iş sonucunu doğrulayın. Fiziksel silme, arşiv ve mali iptali ayrı değerlendirin. Kaynak akışı · İşlem takibi · Kapsam ve sınırlamalar

Yetkilendirmeler

Authorization
string
header
gerekli

Kullanıcı adı apiUserId, parola secretKey. Aktif ve süresi geçmemiş API kullanıcısı ve uygun firma gerekir.

Yol Parametreleri

id
string
gerekli

İşlem yapılacak kayıt kimliği. Kayıt kimliği.

Pattern: ^[a-fA-F0-9]{24}$
Örnek:

"64b000000000000000000001"

Gövde

application/json
title
string

Gönderilirse boş veya null olamaz.

Minimum string length: 1
description
string | null

Açıklama.

dueDate
string<date-time> | null

Son tarih.

users
string[]

Atanan kullanıcı kimliği.

Pattern: ^[a-fA-F0-9]{24}$
labelsId
string[]

Etiket kimliği.

Pattern: ^[a-fA-F0-9]{24}$
isArchived
boolean

Arşiv durumu.

projectId
string

Proje kimliği.

Pattern: ^[a-fA-F0-9]{24}$
Örnek:

"64b000000000000000000001"

compDate
string<date-time> | null

Tamamlanma tarihi.

statusId
string | null

Durum kimliği.

Pattern: ^[a-fA-F0-9]{24}$
Örnek:

"64b000000000000000000001"

contactsId
string[]

Bağlı cari kimliği.

Pattern: ^[a-fA-F0-9]{24}$
salesId
string[]

Bağlı işlem kimliği.

Pattern: ^[a-fA-F0-9]{24}$

Yanıt

İşlem cevabı. Örnek değerler temsilîdir.

status
enum<boolean>
gerekli
Mevcut seçenekler:
true
Örnek:

true