Apelează un instrument fără confirmare

Apelează un instrument al cărui descriptor descoperit are confirmation: “none”. Sunt incluse citirea datelor și continuarea unei încărcări deja autorizate. Trimite {input: {…}} folosind schema corespunzătoare numelui instrumentului din cale. Cererile JSON sunt limitate la 65.536 de octeți. Un răspuns 200 poate conține ok:false.

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

Autorizare

AuthorizationToken Bearer · headerobligatoriu

Cheie API Influence cu permisiuni limitate sau token de acces OAuth acceptat. Nu include datele de acces în URL-uri sau în datele de intrare ale instrumentelor.

Parametri de cale

toolstringobligatoriu

Numele instrumentului returnat de GET /api/v1/tools. Descoperirea este filtrată după permisiunile acestor date de acces; prezența schemei nu confirmă disponibilitatea.

Corpul cererii

obligatoriuapplication/json

inputobjectobligatoriu

Răspunsuri

200

Rezultatul instrumentului; verifică ok și error.

Exact una dintre variante:

object

okbooleanobligatoriu

outputJsonValue | nullobligatoriu

Afișează proprietățile

Una sau mai multe variante:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Tablou cu elemente de tip JsonValue

Referință circulară la JsonValue.

object

object

toolNamestringobligatoriu

Valori permise:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

Valori permise:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatoriu

lungime minimă: 1 · lungime maximă: 2048

retryablebooleanobligatoriu

okbooleanobligatoriu

toolNamestringobligatoriu

400

Cerere nevalidă. Parametrii de interogare nu sunt acceptați. Erorile de validare ale instrumentelor pot folosi structura unui răspuns de eroare al instrumentului.

Una sau mai multe variante:

TransportError

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

ToolError

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

lungime minimă: 1 · lungime maximă: 2048

retryablebooleanobligatoriu

okbooleanobligatoriu

toolNamestringobligatoriu

401

Datele de acces bearer lipsesc, sunt nevalide sau au expirat.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

403

Datele de acces nu au permisiunile necesare.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

404

API-ul pentru acces programatic sau instrumentul solicitat nu este disponibil.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

413

Cererea depășește limita de octeți.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

lungime minimă: 1 · lungime maximă: 2048

retryablebooleanobligatoriu

okbooleanobligatoriu

toolNamestringobligatoriu

429

Limita de frecvență a cererilor a fost depășită. Eroarea permite reîncercarea.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

503

API-ul sau serviciul din amonte care îl execută nu este disponibil.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

Cerere

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

Răspuns

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