Preparar un medio para Instagram

Inspecciona el contenido real de un archivo cargado o de una URL pública y lo adecua al destino de Instagram con un perfil versionado. Guarda el original y el derivado de forma privada con sus SHA-256 y la receta, y devuelve un preparacionId estable. No recorta, no rellena ni silencia: si hiciera falta, responde requiere_decision. No publica, no usa la cuenta de Instagram y no aprueba contenido. El video queda no_disponible mientras Emisso no habilite su motor. Repetir con el mismo origen converge a la misma preparación.

POST
/v1/tools/instagram.medio.preparar/execute
AuthorizationBearer <token>

API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.

In: header

Header Parameters

X-Connect-Connection*string

Cuál conexión (conn_…) ejecuta esta llamada. Obligatoria en todo sistema conectable y sin resolución implícita, ni siquiera cuando la organización tiene una sola conexión activa: la conexión ES la empresa, y elegir por ti una que hoy acierta mañana acierta distinto sin que nadie cambie nada. Los ids salen de la tool 'conexiones.estado.consultar'. Si falta, la respuesta es 'validation_error' y no se contacta al sistema externo.

Match^conn_

Request Body

application/json

La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/tools/instagram.medio.preparar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {      "perfil": "feed_image",      "origen": {        "medioId": "string"      }    }  }'
{  "data": {    "preparacionId": "string",    "estado": "lista",    "motivo": "string",    "mensaje": "string",    "perfil": {      "id": "string",      "version": "string"    },    "original": {      "medioId": "string",      "sha256": "string",      "bytes": -9007199254740991,      "mime": "string",      "inspeccion": {        "tipo": "imagen",        "formato": "jpeg",        "ancho": -9007199254740991,        "alto": -9007199254740991,        "orientacionExif": -9007199254740991,        "animada": true,        "cuadros": -9007199254740991,        "transparencia": true,        "modeloColor": "string",        "perfilIcc": true,        "multiImagen": true      },      "enlace": {        "url": "http://example.com",        "expiraEn": "2019-08-24T14:15:22Z"      }    },    "derivado": {      "medioId": "string",      "sha256": "string",      "bytes": -9007199254740991,      "mime": "string",      "inspeccion": {        "tipo": "imagen",        "formato": "jpeg",        "ancho": -9007199254740991,        "alto": -9007199254740991,        "orientacionExif": -9007199254740991,        "animada": true,        "cuadros": -9007199254740991,        "transparencia": true,        "modeloColor": "string",        "perfilIcc": true,        "multiImagen": true      },      "enlace": {        "url": "http://example.com",        "expiraEn": "2019-08-24T14:15:22Z"      },      "derivadoDe": "string",      "identicoAlOriginal": true    },    "receta": {      "id": "string",      "version": -9007199254740991,      "params": {        "property1": "string",        "property2": "string"      }    },    "transformaciones": [      {        "tipo": "string",        "perceptible": true,        "detalle": {          "property1": "string",          "property2": "string"        }      }    ],    "restricciones": {      "bytes": {        "procesamiento": -9007199254740991,        "upload": -9007199254740991,        "publicacion": -9007199254740991,        "efectivo": -9007199254740991,        "manda": "upload"      },      "incumplimientos": [        {          "codigo": "string",          "capa": "processing",          "resolucion": "remux",          "actual": "string",          "limite": "string"        }      ],      "noVerificado": [        "string"      ],      "avisos": [        "string"      ]    },    "decisiones": [      {        "codigo": "string",        "actual": "string",        "limite": "string",        "remedio": "string"      }    ],    "reintentable": true,    "reintentarEnSegundos": 0  },  "meta": {    "request_id": "string",    "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f",    "tool_id": "string",    "plane": "action",    "latency_ms": 0,    "audit_status": "recorded",    "idempotency": "replayed"  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}