Recevoir des e-mails : Dossiers et compteurs

Créer un dossier

Créez un dossier personnalisé. La réponse vous donne le slug à utiliser dans les autres commandes.

POSThttps://g.sendcorex.com/v1command: create_folder
i

Utilisez le folder (slug) renvoyé dans move, list_threads et les autres commandes. Le nom du dossier fonctionne aussi, mais le slug ne change jamais.

Arguments

  • namestringobligatoire

    Nom du dossier, de 1 à 64 caractères.

  • colorstringfacultatif

    Couleur du dossier.

  • iconstringfacultatif

    Icône du dossier.

Démarrage rapide

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "create_folder",
        args: {
          name: "Projeto X"
        }
      }
    ]
  },
  { 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": "create_folder",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "folder": "projeto-x",
        "name": "Projeto X"
      }
    }
  ]
}

Champs de la réponse

  • folder

    Le slug du dossier.

  • name

    Le nom de dossier que vous avez envoyé.

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.

  • 401TOKEN_EXPIRED

    L'access token a expiré. Appelez Refresh Token et relancez la requête.

  • 401INVALID_TOKEN

    Le token est mal formé, inconnu ou révoqué.

  • 429RATE_LIMITED

    Plus 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.

  • CMDINVALID_ARGS

    Un argument obligatoire est manquant ou invalide.

  • CMDALREADY_EXISTS

    Un dossier ou un libellé portant ce nom existe déjà.

  • CMDINTERNAL

    Erreur serveur. Le détail est uniquement écrit dans le log du serveur.