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.
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
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.
^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 }}Abrir una carga de medio para Instagram POST
Abre una carga privada de un archivo en Emisso para esta conexión, sin pasar los bytes por la llamada. Devuelve el medioId y una URL temporal a la que envías cada parte con PUT. Declaras tipo, tamaño exacto y SHA-256: la carga sólo se completa si coinciden. No publica ni prepara nada. Requiere el permiso de preparación de medios habilitado en Emisso para la conexión.
Ver una preparación de medio de Instagram POST
Devuelve el estado guardado de una preparación de esta conexión, con enlaces temporales nuevos al original y al derivado. No vuelve a descargar ni a procesar nada.