Recibir correos: Flags y etiquetas
Establecer flags
Marca mensajes como leídos o no leídos, destacados e importantes. Funciona con un mensaje o con un lote.
https://g.sendcorex.com/v1command: set_flagsLos comandos en lote responden elemento por elemento, así que un id inexistente no hace fallar a los demás.
Argumentos
idsstring[]opcionalHasta 100 ids de mensaje.
idstringopcionalUn único id de mensaje. Usa este o
ids.is_readbooleanopcionalMarca como leído (
true) o no leído (false).is_starredbooleanopcionalAñade o quita el destacado.
is_importantbooleanopcionalAñade o quita el flag de importante.
scopestringopcionalmessage(por defecto) othread. Solo afecta ais_read.
Inicio rápido
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);Respuesta
{
"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
}
}
]
}Campos de la respuesta
items[].idEl id al que se refiere este elemento.
items[].oktruesi el cambio funcionó para este id.items[].dataEl resultado para este id. Solo cuando
okestrue.items[].code / messageEl error para este id. Solo cuando
okesfalse.ok_count / failed_countCuántos ids funcionaron y cuántos fallaron.
Cómo se comportan los flags
is_read + scope: threadMarca toda la conversación.
is_starred / is_important: trueMarca solo el mensaje del
id.is_starred / is_important: falseQuita el flag en toda la conversación. Una fila de conversación muestra "tiene destacado", así que quitar el destacado tiene que limpiar todos los mensajes.
Errores
Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.
- 401
TOKEN_EXPIREDEl access token expiró. Llama a Refresh Token y repite la solicitud.
- 401
INVALID_TOKENEl token está mal formado, es desconocido o fue revocado.
- 429
RATE_LIMITEDMás de 15 solicitudes/s o 15 en curso para la misma IP + buzón. Espera la cantidad de segundos indicada en Retry-After.
- CMD
INVALID_ARGSFalta un argumento obligatorio o no es válido.
- CMD
NOT_FOUNDEl mensaje, la conversación o la carpeta no existe para este token.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.