Conexión

Conecta una cuenta social o un sitio: manda al usuario a la URL y Marsial lo devuelve a tu redirectUrl.

Empezar a conectar una cuenta

GET/v1/connect/{platform}

Devuelve la URL a la que mandar al usuario. Al terminar, Marsial vuelve a redirectUrl con connected=<platform>&accountId=…, con error=… si falló, o con select=<sessionId> cuando el usuario debe elegir página, organización, tablero, ficha o perfil (Facebook, LinkedIn, Pinterest, Google Business, Snapchat) un canal (Slack) o un número (WhatsApp). Shopify necesita shop (el dominio myshopify.com de la tienda). wordpress aquí conecta sitios de WordPress.com; los autoalojados usan POST /connect/wordpress. Las conexiones de anuncios (meta-ads, google-ads…) también empiezan aquí.

Parámetros

platformstringobligatorio
profileIdstringobligatorio
El perfil al que pertenecerá la cuenta.
redirectUrlstring (uri)obligatorio
A dónde vuelve el usuario cuando termina la conexión.
shopstring
Solo para Shopify, y ahí obligatorio: el dominio myshopify.com de la tienda (o su prefijo).

Respuesta 200

data

urlstring (uri)obligatorio
Manda aquí al usuario para que autorice la red.

curl "https://api.marsial.dev/v1/connect/instagram?profileId=prf_8f2k4d&redirectUrl=https%3A%2F%2Fapp.acme.com%2Fconnected" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

const res = await fetch('https://api.marsial.dev/v1/connect/instagram?profileId=prf_8f2k4d&redirectUrl=https%3A%2F%2Fapp.acme.com%2Fconnected', {
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.marsial.dev/v1/connect/instagram?profileId=prf_8f2k4d&redirectUrl=https%3A%2F%2Fapp.acme.com%2Fconnected",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
)
data = res.json()["data"]

Conectar un WordPress autoalojado

POST/v1/connect/wordpress

Un WordPress autoalojado no tiene OAuth: crea una contraseña de aplicación en el perfil de WordPress del usuario que publicará (Usuarios → Perfil → Contraseñas de aplicación) y envíala con su nombre de usuario. Marsial comprueba el sitio y los permisos antes de guardarlo. Marsial no guarda la contraseña; revócala en WordPress para cortar el acceso.

Cuerpo

profileIdstringobligatorio
El perfil al que pertenecerá el sitio.
siteUrlstring (starts_with)obligatorio
La raíz pública del sitio, por ejemplo https://example.com.
usernamestringobligatorio
El nombre de usuario de WordPress de quien publicará.
máx. 200
applicationPasswordstringobligatorio
Una contraseña de aplicación creada en el perfil de WordPress de ese usuario.
mín. 8máx. 200

Respuesta 201

data

idstringobligatorio
profileIdstringobligatorio
platformstringobligatorio
usernamestring
displayNamestring
avatarUrlstring (uri)
statusstringobligatorio
Valores: active · needs_reconnection · disconnected
connectedAtstring (date-time)obligatorio
updatedAtstring (date-time)obligatorio

curl -X POST "https://api.marsial.dev/v1/connect/wordpress" \
  -H "Authorization: Bearer $MARSIAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prf_8f2k4d",
    "siteUrl": "https://blog.acme.com",
    "username": "editor",
    "applicationPassword": "abcd efgh ijkl mnop qrst uvwx"
  }'

const res = await fetch('https://api.marsial.dev/v1/connect/wordpress', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "profileId": "prf_8f2k4d",
    "siteUrl": "https://blog.acme.com",
    "username": "editor",
    "applicationPassword": "abcd efgh ijkl mnop qrst uvwx"
  }),
});
const { data } = await res.json();

import os, requests

res = requests.post(
    "https://api.marsial.dev/v1/connect/wordpress",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
    json={
        "profileId": "prf_8f2k4d",
        "siteUrl": "https://blog.acme.com",
        "username": "editor",
        "applicationPassword": "abcd efgh ijkl mnop qrst uvwx"
    },
)
data = res.json()["data"]

Listar lo que el usuario puede elegir

GET/v1/connect/sessions/{id}/options

El id es el valor de select que Marsial añadió a tu redirectUrl. Las sesiones caducan a la hora.

Parámetros

idstringobligatorio

Respuesta 200

data

platformstringobligatorio
optionsobject[]obligatorio
options
- idstringobligatorio
- namestringobligatorio
- detailstring
- imageUrlstring (uri)

curl "https://api.marsial.dev/v1/connect/sessions/cs_5t2y8u/options" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

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

import os, requests

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

Elegir una opción y terminar la conexión

POST/v1/connect/sessions/{id}/select

Parámetros

idstringobligatorio

Cuerpo

optionIdstringobligatorio
máx. 200

Respuesta 201

data

idstringobligatorio
profileIdstringobligatorio
platformstringobligatorio
usernamestring
displayNamestring
avatarUrlstring (uri)
statusstringobligatorio
Valores: active · needs_reconnection · disconnected
connectedAtstring (date-time)obligatorio
updatedAtstring (date-time)obligatorio

curl -X POST "https://api.marsial.dev/v1/connect/sessions/cs_5t2y8u/select" \
  -H "Authorization: Bearer $MARSIAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "optionId": "1042…"
  }'

const res = await fetch('https://api.marsial.dev/v1/connect/sessions/cs_5t2y8u/select', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "optionId": "1042…"
  }),
});
const { data } = await res.json();

import os, requests

res = requests.post(
    "https://api.marsial.dev/v1/connect/sessions/cs_5t2y8u/select",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
    json={
        "optionId": "1042…"
    },
)
data = res.json()["data"]