Confirmer une modification

Confirmez les mêmes données préparées avec les deux en-têtes obligatoires. Les règles de vérification et d’approbation humaine des publications restent applicables. Une réponse 200 peut contenir ok:false ; l’acceptation ou la programmation ne prouve pas la publication. Les requêtes JSON sont limitées à 65536 octets.

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

Autorisation

AuthorizationJeton Bearer · headerobligatoire

Clé API Influence avec des autorisations limitées ou jeton d’accès OAuth pris en charge. Ne placez jamais les identifiants dans les URL ni dans les données des outils.

Paramètres de chemin

toolstringobligatoire

Nom d’outil renvoyé par GET /api/v1/tools. La liste dépend des autorisations des identifiants ; la présence d’un schéma ne garantit pas la disponibilité.

Paramètres d’en-tête

X-Publish-ConfirmationConfirmationCapabilityobligatoire

Valeur exacte de confirmationCapability renvoyée par prepare. Envoyez-la uniquement dans cet en-tête, avec les mêmes données, avant expiresAt.

longueur min. : 32 · longueur max. : 4096 · correspond à ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyobligatoire

Identifiant de nouvelle tentative créé par le client. Conservez cette clé, la capacité de confirmation et les données si le résultat est incertain.

longueur min. : 16 · longueur max. : 200 · correspond à ^[A-Za-z0-9._:-]+$

Corps de la requête

obligatoireapplication/json

inputobjectobligatoire

Réponses

200

Résultat de l’outil ; vérifiez ok et error.

Une seule de:

object

okbooleanobligatoire

output__schema0obligatoire

Afficher les propriétés

__schema0

toolNamestringobligatoire

Valeurs autorisées :adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListwhatsappContactListwhatsappTemplateListwhatsappMediaListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsToolgenerateVideoOptionsvideoFunctionToolgenerateVideoToolgenerateImageTooluploadFromUrlTool

object

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

Valeurs autorisées :INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatoire

longueur min. : 1 · longueur max. : 2048

retryablebooleanobligatoire

okbooleanobligatoire

toolNamestringobligatoire

400

Requête non valide. Les paramètres de requête sont refusés. Les erreurs de validation peuvent utiliser l’enveloppe d’erreur d’un outil.

Une ou plusieurs de:

TransportError

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

ToolError

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

Valeurs autorisées :INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatoire

longueur min. : 1 · longueur max. : 2048

retryablebooleanobligatoire

okbooleanobligatoire

toolNamestringobligatoire

401

Identifiant bearer absent, non valide ou expiré.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

403

Les identifiants ne disposent pas des autorisations requises.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

404

L’API ou l’outil demandé est indisponible.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

413

La requête dépasse la limite en octets.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

Valeurs autorisées :INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatoire

longueur min. : 1 · longueur max. : 2048

retryablebooleanobligatoire

okbooleanobligatoire

toolNamestringobligatoire

429

Limite de requêtes dépassée. Une nouvelle tentative est possible.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

503

L’API ou le service chargé de l’exécution est indisponible.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

Requête

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}",
)

Réponse

{
  "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
  }
}