Ver una preparación de medio de Instagram
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.
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.ver/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{ "input": { "preparacionId": "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 }}Preparar un medio para Instagram POST
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.
Publicar en Instagram POST
Publica el contenido aprobado en la única cuenta o página de Instagram de esta conexión. Beta privada: requiere permiso explícito y una Idempotency-Key UUID v4 estable. La persona debe aprobar contenido y destino antes de ejecutar. Un resultado pendiente o desconocido exige revisión, nunca otra clave para repetir el envío. No programa, borra ni modifica publicaciones. Formatos: exige un medio. Una imagen JPEG o carrusel de 2 a 20 imágenes JPEG con texto alternativo, o un único Reel MP4 de hasta 100 MiB (H.264/HEVC, 3 s a 15 min) también compartido al feed. Caption de 2200 caracteres, 30 hashtags y 20 menciones. Por URL, si el canal no termina de procesar el video dentro de la corrida, se informa no_publicado. Alternativamente acepta preparaciones listas; esta variante exige instagram:media e instagram:publish en el emisor y la conexión. Elige original certificado sin cambios o derivado; fija sus hashes, receta, orden y retención. Su contenedor pendiente se continúa exclusivamente con publicacion.reanudar y la operación original, sin repetir un POST incierto.