Recevoir des e-mails : Indicateurs et libellés
Définir les indicateurs
Marquez des messages comme lus ou non lus, suivis et importants. Fonctionne sur un message ou sur un lot.
https://g.sendcorex.com/v1command: set_flagsLes commandes groupées répondent élément par élément : un id manquant ne fait pas échouer les autres.
Arguments
idsstring[]facultatifJusqu'à 100 ids de message.
idstringfacultatifUn seul id de message. Utilisez-le ou
ids.is_readbooleanfacultatifMarque comme lu (
true) ou non lu (false).is_starredbooleanfacultatifAjoute ou retire l'étoile.
is_importantbooleanfacultatifAjoute ou retire l'indicateur important.
scopestringfacultatifmessage(par défaut) outhread. N'affecte queis_read.
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "set_flags",
args: {
ids: [
"Vj0xQUJDMTIz"
],
is_read: true,
scope: "thread"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Réponse
{
"type": "SUCCESS",
"results": [
{
"command": "set_flags",
"id": "0",
"type": "SUCCESS",
"data": {
"items": [
{
"id": "Vj0xQUJDMTIz",
"ok": true,
"data": {
"changed": 2
}
}
],
"ok_count": 1,
"failed_count": 0
}
}
]
}Champs de la réponse
items[].idL'id auquel se rapporte cet élément.
items[].oktruesi la modification a réussi pour cet id.items[].dataLe résultat pour cet id. Uniquement quand
okvauttrue.items[].code / messageL'erreur pour cet id. Uniquement quand
okvautfalse.ok_count / failed_countCombien d'ids ont réussi et combien ont échoué.
Comportement des indicateurs
is_read + scope: threadMarque toute la conversation.
is_starred / is_important: trueMarque uniquement le message de l'
id.is_starred / is_important: falseRetire l'indicateur dans toute la conversation. Une ligne de conversation affiche « a une étoile », donc retirer l'étoile doit la retirer de tous les messages.
Erreurs
Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.
- 401
TOKEN_EXPIREDL'access token a expiré. Appelez Refresh Token et relancez la requête.
- 401
INVALID_TOKENLe token est mal formé, inconnu ou révoqué.
- 429
RATE_LIMITEDPlus de 15 requêtes/s ou 15 en cours pour la même IP + boîte aux lettres. Attendez le nombre de secondes indiqué dans Retry-After.
- CMD
INVALID_ARGSUn argument obligatoire est manquant ou invalide.
- CMD
NOT_FOUNDLe message, la conversation ou le dossier n'existe pas pour ce token.
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.