Individua gli strumenti disponibili

Restituisce i nomi degli strumenti, le descrizioni, gli ambiti di autorizzazione, i requisiti di conferma e gli schemi di input visibili alla credenziale Bearer.

GET/api/v1/tools

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.

Risposte

200

Descrittori degli strumenti disponibili.

toolsobject[]obbligatorio

Mostra le proprietà

Array di object

annotationsobjectobbligatorio

Mostra le proprietà

destructiveHintbooleanobbligatorio

idempotentHintbooleanobbligatorio

openWorldHintbooleanobbligatorio

readOnlyHintbooleanobbligatorio

confirmationstringobbligatorio

Valori consentiti:nonerequired

descriptionstringobbligatorio

lunghezza minima 1 · lunghezza massima 1024

gatestringobbligatorio

Valori consentiti:coregenerative-ai

mutabilitystringobbligatorio

Valori consentiti:readexternal-readwriteexternal-write

namestringobbligatorio

Valori consentiti:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

scopesstring[]obbligatorio

massimo 4 elementi

titlestringobbligatorio

lunghezza minima 1 · lunghezza massima 80

inputSchemaobjectobbligatorio

Mostra le proprietà

typestringobbligatorio

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.

errorobjectobbligatorio

Mostra le proprietà

codestringobbligatorio

messagestringobbligatorio

retryablebooleanobbligatorio

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

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 GET 'https://influence.so/api/v1/tools' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch("https://influence.so/api/v1/tools", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://influence.so/api/v1/tools",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json"
    },
)

Risposta

{
  "tools": [
    {
      "annotations": {
        "destructiveHint": true,
        "idempotentHint": true,
        "openWorldHint": true,
        "readOnlyHint": true
      },
      "confirmation": "none",
      "description": "string",
      "gate": "core",
      "mutability": "read",
      "name": "adAuditQuote",
      "scopes": [
        "integrations:read"
      ],
      "title": "string",
      "inputSchema": {
        "type": "object",
        "property1": "string",
        "property2": "string"
      },
      "property1": "string",
      "property2": "string"
    }
  ],
  "property1": "string",
  "property2": "string"
}

{
  "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": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}