Wywołaj narzędzie bez potwierdzenia

Wywołaj narzędzie, którego udostępniony deskryptor zawiera confirmation: “none”. Obejmuje to odczytywanie danych i kontynuowanie już autoryzowanego przesyłania. Wyślij {input: {…}} zgodnie ze schematem odpowiadającym nazwie narzędzia w ścieżce. Limit żądań JSON wynosi 65 536 bajtów. Odpowiedź 200 może zawierać ok:false.

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

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.

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/call' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -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/call", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "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/call",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "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
  }
}