Kontakty

const page = await openemail.contacts.list({ limit: 100 })  const contact = await openemail.contacts.get('[email protected]')   const saved = await openemail.contacts.create({    email: '[email protected]',    name: 'Grace Hopper',    notes: 'Met at the compiler workshop',  })   await openemail.contacts.update(saved.email, { notes: null })  await openemail.contacts.delete(saved.email)   console.log(page.items.length, page.hasMore, contact.source, contact.lastSeenAt)

Najpierw ostatnio widziane, a kontakty, do których nigdy nie pisano, na końcu. source to auto, gdy wiersz powstał dlatego, że członek wysłał na ten adres wiadomość z kompozytora aplikacji, co jest materialnie inną informacją niż to, że ktoś adres zapisał. Poczta przychodząca z adresu nie zapisuje nic, podobnie jak wysyłka przez to API.

Książka należy do przestrzeni roboczej, a nie do jednej osoby, więc kontakt zapisany przez dowolnego członka jest kontaktem, który widzi każdy członek i każdy klucz. create zapisuje source jako manual i umieszcza kontakt w domyślnej grupie odbiorców już przy zapisie. Wymień własne listy w audienceIds, żeby dołączyć do nich w tym samym wywołaniu, co wymaga również audiences:write, albo dodaj kontakt później przez openemail.audiences.addContact.

contacts.list rozwiązuje się do Page<ContactResource>, więc wiersze są w page.items, a przechodzenie podąża za page.nextCursor, dopóki page.hasMore jest true. get, create i update rozwiązują się każde do jednego ContactDetailResource, czyli tego samego wiersza plus audiences. Książka adresowa jest nieograniczona i dlatego ta trasa stronicuje, zamiast zwracać tablicę, która po cichu kończyła się na 200 wierszach.