Ugrás a dokumentációra
API

Névjegy létrehozása

Egyetlen címet ment a munkaterület címjegyzékébe. A cím maga az identitás, így nincs választható azonosító, és a válaszban sincs. Tárolás előtt levágja róla a szóközöket és kisbetűssé alakítja, a névjegy pedig `manual` értékű `source` mezővel mentődik. Az új névjegy a beírás pillanatában bekerül a beépített alapértelmezett közönségbe, azon felül pedig mindenbe, amit az `audienceIds` megnevez.

POSTapi.openemail.uk/contacts

A valódi hívást futtatja le a munkaterületén, a saját kulcsával.

POST /contacts

Egyetlen címet ment a munkaterület címjegyzékébe. A cím maga az identitás, így nincs választható azonosító, és a válaszban sincs. Tárolás előtt levágja róla a szóközöket és kisbetűssé alakítja, a névjegy pedig manual értékű source mezővel mentődik. Az új névjegy a beírás pillanatában bekerül a beépített alapértelmezett közönségbe, azon felül pedig mindenbe, amit az audienceIds megnevez.

Példa

contacts:write szükséges hozzá. Az audienceIds küldéséhez audiences:write is kell.

curl
curl -X POST "$OE/contacts" -H "$AUTH" -H 'content-type: application/json' -d '{  "email": "[email protected]",  "name": "Grace Hopper",  "notes": "Met at the compiler workshop"}'
Válasz
{  "object": "contact",  "email": "[email protected]",  "name": "Grace Hopper",  "source": "manual",  "notes": "Met at the compiler workshop",  "lastSeenAt": null,  "createdAt": "2026-09-18T09:00:00.000Z",  "updatedAt": "2026-09-18T09:00:00.000Z",  "audiences": [    { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" }  ]}

A címjegyzékben már szereplő cím 409 contact_exists hibát ad, nem összefésülést, így egy újrapróbálkozás nem írhat felül csendben egy nevet, amit valaki az alkalmazásban szerkesztett. Olvasd be a sort, és PATCH-eld helyette.

A lastSeenAt addig null marad, amíg az alkalmazás szerkesztőjéből levél nem megy a címre. A source és a lastSeenAt a szerveré, a törzsben nem fogadja el őket.

Az audienceIds mezőben szereplő olyan közönségazonosító, amely ebben a munkaterületben nem létezik, 404 hibát ad, és semmi nem íródik ki.