API

연락처 목록 조회

워크스페이스 주소록을 가장 최근에 확인된 순으로, 한 번도 메일을 보낸 적 없는 연락처를 마지막에 두고 반환합니다. 워크스페이스의 모든 키가 같은 행을 읽으므로, 한 구성원이 저장한 연락처는 모든 구성원과 모든 키가 보는 연락처입니다. 페이징은 키셋 방식입니다. `limit`은 최대 200까지이며 기본값은 50이고, `hasMore`가 true인 동안 `nextCursor`를 `cursor`로 되돌려 보냅니다.

GETapi.openemail.uk/contacts

본인 키로 워크스페이스에 실제 호출을 실행합니다.

GET /contacts

워크스페이스 주소록을 가장 최근에 확인된 순으로, 한 번도 메일을 보낸 적 없는 연락처를 마지막에 두고 반환합니다. 워크스페이스의 모든 키가 같은 행을 읽으므로, 한 구성원이 저장한 연락처는 모든 구성원과 모든 키가 보는 연락처입니다. 페이징은 키셋 방식입니다. limit은 최대 200까지이며 기본값은 50이고, hasMore가 true인 동안 nextCursor를 cursor로 되돌려 보냅니다.

예시

contacts:read가 필요합니다.

curl

curl "$OE/contacts?limit=50" -H "$AUTH"

응답

{  "object": "list",  "data": [    {      "object": "contact",      "email": "[email protected]",      "name": "Ada Lovelace",      "source": "auto",      "notes": null,      "lastSeenAt": "2026-08-29T08:19:08.000Z",      "createdAt": "2026-08-01T10:00:00.000Z",      "updatedAt": "2026-08-29T08:19:08.000Z"    }  ],  "hasMore": false,  "nextCursor": null}

source는 앱에서든 POST /contacts를 통해서든 누군가 주소를 저장했을 때 manual이고, 구성원이 작성기에서 그 주소로 메일을 보내 기록된 경우에는 auto입니다. 둘은 실질적으로 다른 주장이며(auto는 주고받은 흔적이고 manual은 의도의 흔적입니다) 분기해 볼 가치가 있습니다.

정렬 순서는 lastSeenAt 내림차순에 null을 뒤로 보내고, 그다음은 최신순입니다. 방금 만든 연락처는 lastSeenAt이 없으므로 맨 위가 아니라 맨 끝에 놓입니다.

주소록은 행을 저장한 사람이 아니라 워크스페이스에 속합니다. 어떤 주소에서 메일이 도착하는 것만으로는 아무것도 생성되지 않습니다.