Conferma una modifica

Conferma lo stesso input preparato con entrambi gli header richiesti. Si applicano comunque le regole aggiuntive di revisione della pubblicazione e approvazione umana. Una risposta 200 può contenere ok:false; un’operazione accettata o programmata non dimostra l’avvenuta pubblicazione. Le richieste JSON hanno un limite di 65.536 byte.

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

Autorizzazione

AuthorizationToken Bearer · headerobbligatorio

Chiave API Influence con ambiti di autorizzazione limitati o token di accesso OAuth supportato. Tieni le credenziali fuori dagli URL e dall’input degli strumenti.

Parametri del percorso

toolstringobbligatorio

Nome dello strumento restituito da GET /api/v1/tools. Il rilevamento è filtrato dalle autorizzazioni di questa credenziale; la presenza dello schema non dimostra la disponibilità.

Parametri degli header

X-Publish-ConfirmationConfirmationCapabilityobbligatorio

Il valore esatto di confirmationCapability restituito da prepare. Invialo soltanto in questo header, con lo stesso input, prima di expiresAt.

lunghezza minima 32 · lunghezza massima 4096 · corrisponde a ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyobbligatorio

Identificativo dei nuovi tentativi generato dal chiamante. Conserva questa chiave, la capability e l’input dopo una risposta dall’esito incerto.

lunghezza minima 16 · lunghezza massima 200 · corrisponde a ^[A-Za-z0-9._:-]+$

Corpo della richiesta

obbligatorioapplication/json

inputobjectobbligatorio

Risposte

200

Risultato dello strumento; controlla ok ed error.

Una sola delle seguenti opzioni:

object

okbooleanobbligatorio

outputJsonValue | nullobbligatorio

Mostra le proprietà

Almeno una delle seguenti opzioni:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Array di JsonValue

Riferimento circolare a JsonValue.

object

object

toolNamestringobbligatorio

Valori consentiti:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

Valori consentiti:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobbligatorio

lunghezza minima 1 · lunghezza massima 2048

retryablebooleanobbligatorio

okbooleanobbligatorio

toolNamestringobbligatorio

400

Richiesta non valida. I parametri di query non sono accettati. Gli errori di convalida degli strumenti possono usare una struttura di risposta di errore dello strumento.

Almeno una delle seguenti opzioni:

TransportError

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

retryablebooleanobbligatorio

ToolError

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

lunghezza minima 1 · lunghezza massima 2048

retryablebooleanobbligatorio

okbooleanobbligatorio

toolNamestringobbligatorio

401

Credenziale Bearer mancante, non valida o scaduta.

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

retryablebooleanobbligatorio

403

La credenziale non dispone delle autorizzazioni richieste.

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

retryablebooleanobbligatorio

404

L’API per l’accesso programmatico o lo strumento richiesto non è disponibile.

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

retryablebooleanobbligatorio

413

La richiesta supera il limite in byte.

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

lunghezza minima 1 · lunghezza massima 2048

retryablebooleanobbligatorio

okbooleanobbligatorio

toolNamestringobbligatorio

429

Limite di frequenza superato. È possibile riprovare.

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

retryablebooleanobbligatorio

503

L’API o il servizio di esecuzione a monte non è disponibile.

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

retryablebooleanobbligatorio

Richiesta

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

Risposta

{
  "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": "AI_SCHEDULING_LIMIT_REACHED",
    "message": "string",
    "retryable": true
  },
  "ok": false,
  "toolName": "adAuditQuote"
}

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

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