Cuentas

Cuentas sociales conectadas, si pueden publicar, y sus tableros, listas y subreddits.

Listar cuentas conectadas

GET/v1/accounts

Parámetros

• profileIdstring

Respuesta 200

data []

• idstringobligatorio
• profileIdstringobligatorio
• platformstringobligatorio
• usernamestring
• displayNamestring
• avatarUrlstring (uri)
• statusstringobligatorio

  Valores: active · needs_reconnection · disconnected

• connectedAtstring (date-time)obligatorio
• updatedAtstring (date-time)obligatorio

curl

curl "https://api.marsial.dev/v1/accounts?profileId=prf_8f2k4d" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

Node

const res = await fetch('https://api.marsial.dev/v1/accounts?profileId=prf_8f2k4d', {
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
  },
});
const { data } = await res.json();

Python

import os, requests

res = requests.get(
    "https://api.marsial.dev/v1/accounts?profileId=prf_8f2k4d",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
)
data = res.json()["data"]

Ver una cuenta

GET/v1/accounts/{id}

Parámetros

• idstringobligatorio

Respuesta 200

data

• idstringobligatorio
• profileIdstringobligatorio
• platformstringobligatorio
• usernamestring
• displayNamestring
• avatarUrlstring (uri)
• statusstringobligatorio

  Valores: active · needs_reconnection · disconnected

• connectedAtstring (date-time)obligatorio
• updatedAtstring (date-time)obligatorio

curl

curl "https://api.marsial.dev/v1/accounts/acc_3k9x2m" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

Node

const res = await fetch('https://api.marsial.dev/v1/accounts/acc_3k9x2m', {
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
  },
});
const { data } = await res.json();

Python

import os, requests

res = requests.get(
    "https://api.marsial.dev/v1/accounts/acc_3k9x2m",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
)
data = res.json()["data"]

Desconectar una cuenta

DELETE/v1/accounts/{id}

Parámetros

• idstringobligatorio

Respuesta 204

Sin contenido

curl

curl -X DELETE "https://api.marsial.dev/v1/accounts/acc_3k9x2m" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

Node

await fetch('https://api.marsial.dev/v1/accounts/acc_3k9x2m', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
  },
});

Python

import os, requests

requests.delete(
    "https://api.marsial.dev/v1/accounts/acc_3k9x2m",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
)

Comprobar si las cuentas pueden publicar

GET/v1/accounts/health

Pregunta a cada red en el momento. Las que necesitan reconexión pasan a needs_reconnection.

Parámetros

• profileIdstringobligatorio

Respuesta 200

data []

• accountIdstringobligatorio
• platformstringobligatorio
• statusstringobligatorio

  Valores: healthy · warning · error

• canPostbooleanobligatorio
• needsReconnectionbooleanobligatorio
• issuesstring[]obligatorio

curl

curl "https://api.marsial.dev/v1/accounts/health?profileId=prf_8f2k4d" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

Node

const res = await fetch('https://api.marsial.dev/v1/accounts/health?profileId=prf_8f2k4d', {
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
  },
});
const { data } = await res.json();

Python

import os, requests

res = requests.get(
    "https://api.marsial.dev/v1/accounts/health?profileId=prf_8f2k4d",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
)
data = res.json()["data"]

Comprobar si una cuenta puede publicar

GET/v1/accounts/{id}/health

La misma comprobación que la del perfil, para una cuenta. Los sitios, los CRM y las conexiones de anuncios nunca publican (canPost: false).

Parámetros

• idstringobligatorio

Respuesta 200

data

• accountIdstringobligatorio
• platformstringobligatorio
• statusstringobligatorio

  Valores: healthy · warning · error

• canPostbooleanobligatorio
• needsReconnectionbooleanobligatorio
• issuesstring[]obligatorio

curl

curl "https://api.marsial.dev/v1/accounts/acc_3k9x2m/health" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

Node

const res = await fetch('https://api.marsial.dev/v1/accounts/acc_3k9x2m/health', {
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
  },
});
const { data } = await res.json();

Python

import os, requests

res = requests.get(
    "https://api.marsial.dev/v1/accounts/acc_3k9x2m/health",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
)
data = res.json()["data"]

Listar tableros, listas de reproducción, subreddits o flairs

GET/v1/accounts/{id}/{kind}

kind es pinterest-boards, youtube-playlists, reddit-subreddits o reddit-flairs (con subreddit). Usa los ids en las opciones del post.

Parámetros

• idstringobligatorio
• kindstringobligatorio

  Valores: pinterest-boards · youtube-playlists · reddit-subreddits · reddit-flairs

• subredditstring

  Obligatorio para reddit-flairs.

Respuesta 200

data []

• idstringobligatorio

  Envíalo como boardId, playlistId, subreddit o flairId.

• namestringobligatorio
• detailstring
• isDefaultboolean

  El de la cuenta por defecto, que se usa si el post no elige otro.

curl

curl "https://api.marsial.dev/v1/accounts/acc_3k9x2m/{kind}" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

Node

const res = await fetch('https://api.marsial.dev/v1/accounts/acc_3k9x2m/{kind}', {
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
  },
});
const { data } = await res.json();

Python

import os, requests

res = requests.get(
    "https://api.marsial.dev/v1/accounts/acc_3k9x2m/{kind}",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
)
data = res.json()["data"]

Qué sincroniza una cuenta de CRM

GET/v1/accounts/{id}/crm-settings

Las cuentas de HubSpot no publican: convierten a quien escribe a la bandeja del perfil en contactos y guardan cada mensaje en su ficha.

Parámetros

• idstringobligatorio

Respuesta 200

data

• syncContactsbooleanobligatorio

  Crear un contacto en el CRM por cada persona nueva que escriba.

• logMessagesbooleanobligatorio

  Guardar cada mensaje de la bandeja en el historial del contacto.

curl

curl "https://api.marsial.dev/v1/accounts/acc_3k9x2m/crm-settings" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

Node

const res = await fetch('https://api.marsial.dev/v1/accounts/acc_3k9x2m/crm-settings', {
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
  },
});
const { data } = await res.json();

Python

import os, requests

res = requests.get(
    "https://api.marsial.dev/v1/accounts/acc_3k9x2m/crm-settings",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
)
data = res.json()["data"]

Activar o desactivar la sincronización con el CRM

PATCH/v1/accounts/{id}/crm-settings

Parámetros

• idstringobligatorio

Cuerpo

• syncContactsboolean

  Crear un contacto en el CRM por cada persona nueva que escriba.

• logMessagesboolean

  Guardar cada mensaje de la bandeja en el historial del contacto.

Respuesta 200

data

• syncContactsbooleanobligatorio

  Crear un contacto en el CRM por cada persona nueva que escriba.

• logMessagesbooleanobligatorio

  Guardar cada mensaje de la bandeja en el historial del contacto.

curl

curl -X PATCH "https://api.marsial.dev/v1/accounts/acc_3k9x2m/crm-settings" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

Node

const res = await fetch('https://api.marsial.dev/v1/accounts/acc_3k9x2m/crm-settings', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
  },
});
const { data } = await res.json();

Python

import os, requests

res = requests.patch(
    "https://api.marsial.dev/v1/accounts/acc_3k9x2m/crm-settings",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
)
data = res.json()["data"]