SDK
Brouillons
`drafts.list`, `listAll`, `iterate`, `get`, `create`, `update` et `delete`.
Toutes les méthodes
const page = await openemail.drafts.list({ query: 'invoice', limit: 25 })const draft = await openemail.drafts.get('draft_…') const created = await openemail.drafts.create({ to: ['[email protected]'], cc: [], bcc: [], subject: 'Your September invoice', html: '<p>Draft body.</p>', from: '[email protected]', threadId: 'thread_…',}) const updated = await openemail.drafts.update(created.id!, { subject: 'Revised' })await openemail.drafts.delete(updated.id!)update conserve l'id du brouillon : la valeur qu'il renvoie est donc toujours celle que vous avez transmise. Un id inconnu donne un 404 plutôt qu'un nouveau brouillon.
list pagine comme threads.list : le pageToken de l'API revient sous le nom nextCursor et se transmet sous le nom cursor, et listAll et iterate le suivent pour vous.
Pour envoyer un brouillon, transmettez son id à emails.send. Le brouillon fournit le contenu, l'envoi fournit l'enveloppe.
await openemail.emails.send({ from: '[email protected]', to: '[email protected]', draftId: 'draft_…',})Paramètres : drafts.create et drafts.update (DraftInput)
tostring[]- Les adresses des destinataires sous forme de chaînes simples, et non dans les formes `RecipientInput` qu'accepte `emails.send`, car ce point de terminaison assemble le tableau en la liste séparée par des virgules qu'attend le driver. À la création, un tableau omis est enregistré comme vide ; à la mise à jour, un champ omis laisse les destinataires stockés intacts, car le handler lit d'abord le brouillon puis fusionne.
ccstring[]- Les adresses Cc, dans la même forme de chaîne simple que `to`. Vide à la création si omis, et intact à la mise à jour si omis.
bccstring[]- Les adresses Bcc, dans la même forme de chaîne simple que `to`. Vide à la création si omis, et intact à la mise à jour si omis.
subjectstring- L'objet du brouillon, 998 caractères au maximum, la limite de ligne RFC 5322. À la création, il vaut par défaut une chaîne vide : un brouillon en a donc toujours un.
htmlstring- Le corps du brouillon sous forme de balisage, 1 000 000 caractères au maximum. C'est le corps qui l'emporte : `html` et `text` alimentent l'unique champ de message du driver, donc envoyer les deux enregistre celui-ci.
textstring- Un corps en texte brut, 1 000 000 caractères au maximum, utilisé uniquement en l'absence de `html`. Le brouillon stocke un seul corps plutôt que deux parties : le texte fourni ici revient donc sur `html` à la lecture du brouillon.
fromstring- L'adresse d'expédition à enregistrer sur le brouillon. À la mise à jour, elle est reprise du brouillon stocké si elle est omise. Le driver reconstruit tout le message à partir de ce qu'on lui transmet : un patch partiel qui l'omettrait changerait donc silencieusement l'expéditeur choisi.
threadIdstring- Rattache le brouillon à un thread existant pour qu'il soit enregistré comme une réponse. Comme `from`, il est repris à la mise à jour s'il est omis, car reconstruire le message sans lui détacherait la réponse de son thread.
Réponse : DraftResource (drafts.get)
object'draft'- Toujours `draft`.
idstring- L'id du brouillon. Les écritures répondent avec un `SavedDraftResource` plutôt qu'avec un brouillon complet : lisez donc l'id sur le résultat au lieu de réutiliser celui que vous avez envoyé.
tostring[]- Les adresses des destinataires telles que le brouillon les a stockées. Un array vide, jamais null, quand le brouillon n'en a aucune.
ccstring[]- Les adresses Cc telles que stockées. Un array vide, jamais null, quand le brouillon n'en a aucune.
bccstring[]- Les adresses Bcc telles que stockées. Un array vide, jamais null, quand le brouillon n'en a aucune.
subjectstring- L'objet stocké, ou une chaîne vide quand le brouillon n'en a pas. Ce champ n'est jamais null : vérifiez sa longueur plutôt que sa présence.
htmlstring- Le corps stocké, ou une chaîne vide quand le brouillon n'en a pas. Il n'existe pas de champ text distinct en sortie : un brouillon enregistré avec `text` seul est renvoyé ici.