Bekreft en endring

Bekreft de samme klargjorte inndataene med begge de påkrevde HTTP-hodene. Ytterligere regler for publiseringsgjennomgang og menneskelig godkjenning gjelder fortsatt. Et svar med status 200 kan inneholde ok:false. Arbeid som er godtatt eller planlagt, er ikke et bevis på publisering. JSON-forespørsler er begrenset til 65 536 byte.

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

Autorisasjon

AuthorizationBearer-token · headerpåkrevd

Influence-API-nøkkel med avgrenset tilgang eller et støttet OAuth-tilgangstoken. Hold tilgangsopplysninger utenfor URL-er og inndata til verktøy.

Stiparametere

toolstringpåkrevd

Verktøynavn som returneres av GET /api/v1/tools. Oppslaget filtreres etter tillatelsene som tilgangsopplysningene gir. At et skjema finnes, bekrefter ikke at verktøyet er tilgjengelig.

Parametere i HTTP-hoder

X-Publish-ConfirmationConfirmationCapabilitypåkrevd

Den nøyaktige confirmationCapability-verdien som returneres av prepare. Send den bare i dette HTTP-hodet, med de samme inndataene, før expiresAt.

minste lengde: 32 · maksimal lengde: 4096 · samsvarer med ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeypåkrevd

Identifikator for nye forsøk, generert av den som gjør kallet. Behold denne nøkkelen, bekreftelsesverdien og inndataene etter et svar med usikkert utfall.

minste lengde: 16 · maksimal lengde: 200 · samsvarer med ^[A-Za-z0-9._:-]+$

Forespørselskropp

påkrevdapplication/json

inputobjectpåkrevd

Svar

200

Verktøyresultat. Kontroller ok og error.

Nøyaktig ett av:

object

okbooleanpåkrevd

outputJsonValue | nullpåkrevd

Vis egenskaper

Minst ett av:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Liste med JsonValue

Sirkulær referanse til JsonValue.

object

object

toolNamestringpåkrevd

Tillatt:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectpåkrevd

Vis egenskaper

codestringpåkrevd

Tillatt:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringpåkrevd

minste lengde: 1 · maksimal lengde: 2048

retryablebooleanpåkrevd

okbooleanpåkrevd

toolNamestringpåkrevd

400

Ugyldig forespørsel. Spørringsparametere godtas ikke. Feil ved verktøyvalidering kan returneres i et omsluttende feilobjekt for verktøy.

Minst ett av:

TransportError

errorobjectpåkrevd

Vis egenskaper

codestringpåkrevd

messagestringpåkrevd

retryablebooleanpåkrevd

ToolError

errorobjectpåkrevd

Vis egenskaper

codestringpåkrevd

Tillatt:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringpåkrevd

minste lengde: 1 · maksimal lengde: 2048

retryablebooleanpåkrevd

okbooleanpåkrevd

toolNamestringpåkrevd

401

Tilgangsopplysningene for Bearer-autentisering mangler, er ugyldige eller har utløpt.

errorobjectpåkrevd

Vis egenskaper

codestringpåkrevd

messagestringpåkrevd

retryablebooleanpåkrevd

403

Tilgangsopplysningene mangler nødvendige tillatelser.

errorobjectpåkrevd

Vis egenskaper

codestringpåkrevd

messagestringpåkrevd

retryablebooleanpåkrevd

404

Maskin-API-et eller det forespurte verktøyet er utilgjengelig.

errorobjectpåkrevd

Vis egenskaper

codestringpåkrevd

messagestringpåkrevd

retryablebooleanpåkrevd

413

Forespørselen overskrider bytegrensen.

errorobjectpåkrevd

Vis egenskaper

codestringpåkrevd

Tillatt:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringpåkrevd

minste lengde: 1 · maksimal lengde: 2048

retryablebooleanpåkrevd

okbooleanpåkrevd

toolNamestringpåkrevd

429

Grensen for forespørsler per tidsrom er overskredet. Du kan prøve på nytt ved denne feilen.

errorobjectpåkrevd

Vis egenskaper

codestringpåkrevd

messagestringpåkrevd

retryablebooleanpåkrevd

503

API-et eller kjøringen det avhenger av, er utilgjengelig.

errorobjectpåkrevd

Vis egenskaper

codestringpåkrevd

messagestringpåkrevd

retryablebooleanpåkrevd

Forespørsel

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

Svar

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