apxtri/adminapi
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

new doc

Browse Source
This commit is contained in:
philc 2025-02-10 16:49:23 +01:00
parent 3195ecbd4d
commit bf37c601ad
1 changed files with 7 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
apxtri/routes/notifications.js
View File

@ -44,7 +44,7 @@ router.get("/messages/:alias/:tribeId", (req, res) => {
/**
* @api {POST} adminapi/notifications/sendmail/:tribe/:template - Send personnalize emails
* @apiName Sendmail
* @apiDescription Send campain personnalized email by rendering a template store in ../../{tribe}/template/{template}.js containing email key like html, subject, text, cc,.. as mustache templatewith blank test replaced by data.<br> It use a smtp in conf global or in /itm/{tribe}.json that must have valid parameter emailcontact must be authorized by the smtp <br>
* @apiDescription Send campain personnalized email by rendering a template store in {tribe}/template/{template}.js containing email key like html, subject, text, cc,.. as mustache templatewith blank test replaced by data.<br> It use a smtp in conf global or in adminapi/objects/tribes/itm/{tribe}.json that must have valid parameter emailcontact must be authorized by the smtp <br>
* "emailcontact": "noreply@smatchit.io",<br>
* "smtp": {<br>
* "host": "smtp-relay.brevo.com",<br>
@ -54,15 +54,13 @@ router.get("/messages/:alias/:tribeId", (req, res) => {
* "user": "xx",
* "pass": "yy"
* }<br>
* }
* @apiGroup Notifications
*
* @apiParam {string} template that must exist in {tribe}/template/{template}_{lg}.js that contain all email component (html, text, attachement...)
* @apiParam {string} tribe
* @apiBody {object} emailstosend {emailsto:[{to:[emailslist], cc:[],bcc:[],attachments:[] and any key:value specific for this email}], key:value common to all email that will be include in each email} each item af emailsto is a mail that will be send.<br> If one email of emailsto[].to is not valid then it will be store in result.fail:[{to:emailerror,err:["errorformat"]}], then for well formated email, the result of an email will be store in results.success:[{to:emailsto[].to.emailslist.join(","),status:smtp status}]
* @apiBody {object} emailstosend Format like { emailsto:[{to:[emailslist], cc:[],bcc:[],attachments:[],any key:value specific for this email}], any key:value common to all emails}<br> Each item af emailsto is a mail that will be send.<br> If one email of emailsto[].to is not valid then it will be store in result.fail:[{to:emailerror,err:["errorformat"]}], then for well formated email, the result of an email will be store in results.success:[{to:emailsto[].to.emailslist.join(","),status:smtp status}]
*
* @apiSuccess {object} notif content
* @apiSuccessExample {json} Success-Response:
* HTTP/1.1 200 OK
* {status:200,ref:"Notification",msg:"emailmanage",data:{emailsuccess:"number of mail sent",emailfail:"number of email adresse rejected",failsdetail:[{to:emailerror,err:["errorformat"]}]
@ -193,7 +191,7 @@ router.get(
);
/**
* @api {GET} adminapi/notifications/stat/maillinglst/:tribe --Statistic maillinglst
* @api {GET} adminapi/notifications/stat/maillinglst/:tribe - Statistic maillinglst
* @apiName statmaillinglst
* @apiGroup Notifications
* @apiDescription Mailling list statistique