API

連絡先とのアクティビティを読む

アプリの連絡先にあるアクティビティタブの数値を、現在までの期間について返します。そのアドレスから受け取ったメッセージとそのアドレスへ送ったメッセージの区間ごとの数、動きのあったスレッド、メールボックスからの返信を待っているスレッド、双方が最後に書いた時刻、そして双方が返信にかける時間の中央値です。

GETapi.openemail.uk/contacts/{email}/activity

実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。

GET /contacts/{email}/activity

例

threads:read が必要です。minutes は期間をどこまでさかのぼるかを決め、既定値は 90 日です。grain は minute、hour、day のいずれかで、offsetMinutes は読み手の UTC からのオフセットです。

curl

curl "$OE/contacts/ada%40example.com/activity?minutes=43200&grain=day&offsetMinutes=120" -H "$AUTH"

レスポンス

{  "object": "contact_activity",  "email": "[email protected]",  "since": "2026-08-24T22:00:00.000Z",  "until": "2026-09-23T10:30:00.000Z",  "grain": "day",  "buckets": [    { "bucket": "2026-09-21", "received": 2, "sent": 1 },    { "bucket": "2026-09-22", "received": 1, "sent": 0 }  ],  "totals": {    "received": 3,    "sent": 1,    "threads": 2,    "waiting": 1,    "lastReceivedAt": "2026-09-22T16:04:11.000Z",    "lastSentAt": "2026-09-21T09:40:00.000Z"  },  "replyTime": { "yours": 5400000, "theirs": 12600000 }}

buckets にはメールのある区間だけが古い順に入り、読み手の時刻で名前が付くので、グラフの側で空白を埋めてください。waiting は、最新のメッセージがこのアドレスからのものであるスレッドを数えます。

replyTime はミリ秒単位の中央値で、yours はメールボックスが相手に返信するまで、theirs は相手がメールボックスに返信するまでの時間です。測る返信がないときは null です。ごみ箱や迷惑メールにあるメールは含みません。