Přejít na dokumentaci
API

Seznam kontaktů

Adresář workspace, naposledy viděné první, kontakty, kterým nikdy nic neodešlo, na konci. Všechny klíče ve workspace čtou tytéž řádky, takže kontakt uložený jedním členem vidí každý člen i každý klíč. Stránkuje se keysetem: `limit` jde až na 200 a výchozí hodnota je 50, a `nextCursor` posílejte zpět jako `cursor`, dokud je `hasMore` true.

GETapi.openemail.uk/contacts

Spustí skutečné volání proti vašemu pracovnímu prostoru, s vaším vlastním klíčem.

GET /contacts

Adresář workspace, naposledy viděné první, kontakty, kterým nikdy nic neodešlo, na konci. Všechny klíče ve workspace čtou tytéž řádky, takže kontakt uložený jedním členem vidí každý člen i každý klíč. Stránkuje se keysetem: limit jde až na 200 a výchozí hodnota je 50, a nextCursor posílejte zpět jako cursor, dokud je hasMore true.

Příklad

Vyžaduje contacts:read.

curl
curl "$OE/contacts?limit=50" -H "$AUTH"
Odpověď
{  "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 je manual, když adresu někdo uložil – v aplikaci nebo přes POST /contacts – a auto, když se zaznamenala proto, že na ni člen poslal poštu z editoru zpráv. Jsou to věcně různá tvrzení (auto je důkaz korespondence, manual je důkaz úmyslu) a vyplatí se podle nich větvit.

Řadí se podle lastSeenAt sestupně s hodnotami null na konci, poté od nejnovějšího. Kontakt, který jste právě vytvořili, nemá lastSeenAt, a řadí se tedy na konec, ne na začátek.

Adresář patří workspace, ne tomu, kdo řádek uložil. Pošta přicházející z nějaké adresy nevytváří nic.