Bekræft en ændring

Bekræft det samme forberedte input med begge påkrævede headere. Yderligere regler for udgivelsesgennemgang og godkendelse fra et menneske gælder stadig. Et 200-svar kan indeholde ok:false; accepteret eller planlagt arbejde er ikke bevis på udgivelse. JSON-anmodninger er begrænset til 65.536 bytes.

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

Autorisation

AuthorizationBearer-token · headerpåkrævet

Influence-API-nøgle med afgrænsede tilladelser eller understøttet OAuth-adgangstoken. Hold adgangsoplysninger ude af URL’er og værktøjsinput.

Stiparametre

toolstringpåkrævet

Værktøjsnavn returneret af GET /api/v1/tools. Værktøjsoversigten filtreres efter adgangsoplysningernes tilladelser; et skema betyder ikke i sig selv, at værktøjet er tilgængeligt.

Headerparametre

X-Publish-ConfirmationConfirmationCapabilitypåkrævet

Den præcise confirmationCapability, som prepare returnerede. Send den kun i denne header med det samme input før expiresAt.

min. længde: 32 · maks. længde: 4096 · matcher ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeypåkrævet

Identitet for genforsøg, genereret af den kaldende part. Bevar denne nøgle, bekræftelsesværdien og inputtet efter et svar med uklart resultat.

min. længde: 16 · maks. længde: 200 · matcher ^[A-Za-z0-9._:-]+$

Anmodningsindhold

påkrævetapplication/json

inputobjectpåkrævet

Svar

200

Værktøjsresultat; kontrollér ok og error.

Præcis én af:

object

okbooleanpåkrævet

outputJsonValue | nullpåkrævet

Vis egenskaber

En eller flere af:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Array af JsonValue

Cirkulær reference til JsonValue.

object

object

toolNamestringpåkrævet

Tilladte værdier:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

Tilladte værdier:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringpåkrævet

min. længde: 1 · maks. længde: 2048

retryablebooleanpåkrævet

okbooleanpåkrævet

toolNamestringpåkrævet

400

Ugyldig anmodning. Forespørgselsparametre accepteres ikke. Valideringsfejl i et værktøj kan returneres i værktøjets fejlformat.

En eller flere af:

TransportError

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

retryablebooleanpåkrævet

ToolError

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

min. længde: 1 · maks. længde: 2048

retryablebooleanpåkrævet

okbooleanpåkrævet

toolNamestringpåkrævet

401

Manglende, ugyldige eller udløbne Bearer-adgangsoplysninger.

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

retryablebooleanpåkrævet

403

Adgangsoplysningerne mangler de påkrævede tilladelser.

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

retryablebooleanpåkrævet

404

Maskin-API’et eller det ønskede værktøj er ikke tilgængeligt.

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

retryablebooleanpåkrævet

413

Anmodningen overskrider bytegrænsen.

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

min. længde: 1 · maks. længde: 2048

retryablebooleanpåkrævet

okbooleanpåkrævet

toolNamestringpåkrævet

429

Kaldgrænsen er overskredet. Der kan forsøges igen.

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

retryablebooleanpåkrævet

503

API’et eller den bagvedliggende afvikling er ikke tilgængelig.

errorobjectpåkrævet

Vis egenskaber

codestringpåkrævet

messagestringpåkrævet

retryablebooleanpåkrævet

Anmodning

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