Confirmar una modificación

Confirma los mismos datos preparados con las dos cabeceras obligatorias. Siguen aplicándose las reglas de revisión y aprobación humana de publicaciones. Una respuesta 200 puede contener ok:false; aceptar o programar un trabajo no demuestra que se haya publicado. Las solicitudes JSON tienen un límite de 65536 bytes.

POST/api/v1/tools/{tool}/confirm

Autorización

AuthorizationToken Bearer · headerobligatorio

Clave de API de Influence con permisos limitados o token de acceso OAuth compatible. No incluyas credenciales en las URL ni en los datos de entrada de las herramientas.

Parámetros de ruta

toolstringobligatorio

Nombre de herramienta devuelto por GET /api/v1/tools. La lista depende de los permisos de las credenciales; la presencia de un esquema no garantiza disponibilidad.

Parámetros de cabecera

X-Publish-ConfirmationConfirmationCapabilityobligatorio

El valor exacto de confirmationCapability devuelto por prepare. Envíalo solo en esta cabecera, con los mismos datos de entrada, antes de expiresAt.

longitud mín.: 32 · longitud máx.: 4096 · coincide con ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyobligatorio

Identificador de reintento generado por el cliente. Conserva esta clave, la capacidad de confirmación y los datos de entrada si el resultado es incierto.

longitud mín.: 16 · longitud máx.: 200 · coincide con ^[A-Za-z0-9._:-]+$

Cuerpo de la solicitud

obligatorioapplication/json

inputobjectobligatorio

Respuestas

200

Resultado de la herramienta; comprueba ok y error.

Una de:

object

okbooleanobligatorio

output__schema0obligatorio

Mostrar propiedades

__schema0

toolNamestringobligatorio

Valores permitidos:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListwhatsappContactListwhatsappTemplateListwhatsappMediaListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsToolgenerateVideoOptionsvideoFunctionToolgenerateVideoToolgenerateImageTooluploadFromUrlTool

object

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

Valores permitidos:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatorio

longitud mín.: 1 · longitud máx.: 2048

retryablebooleanobligatorio

okbooleanobligatorio

toolNamestringobligatorio

400

Solicitud no válida. No se aceptan parámetros de consulta. Los fallos de validación pueden usar el formato de error de la herramienta.

Una o más de:

TransportError

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

ToolError

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

Valores permitidos:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatorio

longitud mín.: 1 · longitud máx.: 2048

retryablebooleanobligatorio

okbooleanobligatorio

toolNamestringobligatorio

401

Credencial bearer ausente, no válida o caducada.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

403

Las credenciales no tienen los permisos necesarios.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

404

La API o la herramienta solicitada no está disponible.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

413

La solicitud supera el límite de bytes.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

Valores permitidos:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatorio

longitud mín.: 1 · longitud máx.: 2048

retryablebooleanobligatorio

okbooleanobligatorio

toolNamestringobligatorio

429

Se ha superado el límite de solicitudes. Se puede reintentar.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

503

La API o el servicio que ejecuta la operación no está disponible.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

Solicitud

curl -X POST 'https://influence.so/api/v1/tools/string/confirm' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Publish-Confirmation: stringstringstringstringstringst' \
  -H 'Idempotency-Key: stringstringstri' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "property1": "string",
    "property2": "string"
  }
}'

const response = await fetch("https://influence.so/api/v1/tools/string/confirm", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "X-Publish-Confirmation": "stringstringstringstringstringst",
    "Idempotency-Key": "stringstringstri",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"input\": {\n    \"property1\": \"string\",\n    \"property2\": \"string\"\n  }\n}"
});

import requests

response = requests.post(
    "https://influence.so/api/v1/tools/string/confirm",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "X-Publish-Confirmation": "stringstringstringstringstringst",
        "Idempotency-Key": "stringstringstri",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"input\": {\n    \"property1\": \"string\",\n    \"property2\": \"string\"\n  }\n}",
)

Respuesta

{
  "ok": true,
  "output": "string",
  "toolName": "adAuditQuote"
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "string",
    "retryable": true
  },
  "ok": false,
  "toolName": "adAuditQuote"
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}