Conexión

Conecta una cuenta social: manda al usuario a la URL y Crier 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, Crier 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).

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.

Respuesta 200

data

• urlstring (uri)obligatorio

  Manda aquí al usuario para que autorice la red.

curl

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

Node

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

Python

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/connect/instagram?profileId=prf_8f2k4d&redirectUrl=https%3A%2F%2Fapp.acme.com%2Fconnected",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
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 Crier 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

curl "https://api.usecrier.com/v1/connect/sessions/cs_5t2y8u/options" \
  -H "Authorization: Bearer $CRIER_API_KEY"

Node

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

Python

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/connect/sessions/cs_5t2y8u/options",
    headers={"Authorization": f"Bearer {os.environ['CRIER_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

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

Node

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

Python

import os, requests

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