Ana içeriğe atla
GET

Ne yapar?

Firma ortak notlarını ve API kullanıcısının oluşturduğu özel notları listeler. Başka kullanıcılara ait özel notlar gösterilmez. Varsayılan olarak arşivlenmemiş notlar, oluşturulma tarihine göre yeniden eskiye sıralanır.

Ön koşullar ve izin

Etkin API anahtarı ve muhasip:agenda:read 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

Dönen kimlik ve durumları saklayın; iş akışınızın ilgili detay veya yazma adımında kullanın. 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.

Sorgu Parametreleri

page
integer
varsayılan:1
Gerekli aralık: x >= 1
limit
integer
varsayılan:50
Gerekli aralık: 1 <= x <= 250
q
string

Başlıkta düz metin araması.

Maximum string length: 500
isArchived
boolean
varsayılan:false
isTask
boolean
isPin
boolean
labelsId
string

24 karakterli Muhasip kayıt kimliği.

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

Görev tarihi alt sınırı; ISO tarih.

taskEnd
string

Görev tarihi üst sınırı; yalnız gün ise gün sonu dahil.

filter
enum<string>

slug ile birlikte kullanılır.

Mevcut seçenekler:
filter,
label
slug
string

filter=filter: pinned/tasks/delay/index/archived; filter=label: etiket kimliği.

Yanıt

İşlem cevabı; örnek temsilîdir.

status
boolean
gerekli
result
object[]
gerekli
title
string
gerekli
total
integer
gerekli