Potwierdź zmianę

Potwierdź te same przygotowane dane wejściowe z oboma wymaganymi nagłówkami. Nadal obowiązują dodatkowe zasady weryfikacji przed publikacją i zatwierdzenia przez człowieka. Odpowiedź 200 może zawierać ok:false; przyjęcie operacji lub zaplanowanie publikacji nie jest dowodem opublikowania. Limit żądań JSON wynosi 65 536 bajtów.

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

Autoryzacja

AuthorizationToken Bearer · headerwymagane

Klucz API Influence o ograniczonym zakresie uprawnień lub obsługiwany token dostępu OAuth. Nie umieszczaj danych uwierzytelniających w adresach URL ani danych wejściowych narzędzi.

Parametry ścieżki

toolstringwymagane

Nazwa narzędzia zwrócona przez GET /api/v1/tools. Wykrywanie jest filtrowane według uprawnień tych danych uwierzytelniających; obecność schematu nie oznacza dostępności.

Parametry nagłówka

X-Publish-ConfirmationConfirmationCapabilitywymagane

Dokładna wartość confirmationCapability zwrócona przez prepare. Wyślij ją tylko w tym nagłówku, z tymi samymi danymi wejściowymi, przed expiresAt.

min. długość: 32 · maks. długość: 4096 · pasuje do wzorca ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeywymagane

Identyfikator ponowienia wygenerowany przez wywołującego. Po niepewnej odpowiedzi zachowaj ten klucz, wartość confirmationCapability i dane wejściowe.

min. długość: 16 · maks. długość: 200 · pasuje do wzorca ^[A-Za-z0-9._:-]+$

Treść żądania

wymaganeapplication/json

inputobjectwymagane

Odpowiedzi

200

Wynik narzędzia; sprawdź ok i error.

Dokładnie jeden z:

object

okbooleanwymagane

outputJsonValue | nullwymagane

Pokaż właściwości

Co najmniej jeden z:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Tablica elementów typu JsonValue

Odwołanie cykliczne do JsonValue.

object

object

toolNamestringwymagane

Dozwolone wartości:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectwymagane

Pokaż właściwości

codestringwymagane

Dozwolone wartości:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringwymagane

min. długość: 1 · maks. długość: 2048

retryablebooleanwymagane

okbooleanwymagane

toolNamestringwymagane

400

Nieprawidłowe żądanie. Parametry zapytania nie są przyjmowane. Błędy walidacji narzędzia mogą mieć strukturę odpowiedzi błędu narzędzia.

Co najmniej jeden z:

TransportError

errorobjectwymagane

Pokaż właściwości

codestringwymagane

messagestringwymagane

retryablebooleanwymagane

ToolError

errorobjectwymagane

Pokaż właściwości

codestringwymagane

messagestringwymagane

min. długość: 1 · maks. długość: 2048

retryablebooleanwymagane

okbooleanwymagane

toolNamestringwymagane

401

Nie podano danych uwierzytelniających Bearer albo są one nieprawidłowe lub wygasły.

errorobjectwymagane

Pokaż właściwości

codestringwymagane

messagestringwymagane

retryablebooleanwymagane

403

Dane uwierzytelniające nie obejmują wymaganych uprawnień.

errorobjectwymagane

Pokaż właściwości

codestringwymagane

messagestringwymagane

retryablebooleanwymagane

404

API dla klientów maszynowych lub żądane narzędzie jest niedostępne.

errorobjectwymagane

Pokaż właściwości

codestringwymagane

messagestringwymagane

retryablebooleanwymagane

413

Żądanie przekracza limit bajtów.

errorobjectwymagane

Pokaż właściwości

codestringwymagane

messagestringwymagane

min. długość: 1 · maks. długość: 2048

retryablebooleanwymagane

okbooleanwymagane

toolNamestringwymagane

429

Przekroczono limit częstotliwości żądań. Ten błąd pozwala na ponowienie próby.

errorobjectwymagane

Pokaż właściwości

codestringwymagane

messagestringwymagane

retryablebooleanwymagane

503

API lub jego zaplecze wykonawcze jest niedostępne.

errorobjectwymagane

Pokaż właściwości

codestringwymagane

messagestringwymagane

retryablebooleanwymagane

Żądanie

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

Odpowiedź

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