Chiama uno strumento senza conferma

Chiama uno strumento il cui descrittore restituito dal rilevamento contiene confirmation: “none”. Questo include la lettura dei dati e la prosecuzione di un caricamento già autorizzato. Invia {input: {…}} usando lo schema che corrisponde al nome dello strumento nel percorso. Le richieste JSON hanno un limite di 65.536 byte. Una risposta 200 può contenere ok:false.

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

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à.

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

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