Consultar las herramientas disponibles

Devuelve los nombres, las descripciones, los permisos, los requisitos de confirmación y los esquemas de entrada de las herramientas disponibles para estas credenciales.

GET/api/v1/tools

Autorización

AuthorizationToken Bearer · headerobligatorio

Clave de API de Influence con permisos limitados o token de acceso OAuth compatible. No incluyas credenciales en las URL ni en los datos de entrada de las herramientas.

Respuestas

200

Descriptores de las herramientas disponibles.

toolsobject[]obligatorio

Mostrar propiedades

Array de object

annotationsobjectobligatorio

Mostrar propiedades

destructiveHintbooleanobligatorio

idempotentHintbooleanobligatorio

openWorldHintbooleanobligatorio

readOnlyHintbooleanobligatorio

confirmationstringobligatorio

Valores permitidos:nonerequired

descriptionstringobligatorio

longitud mín.: 1 · longitud máx.: 1024

gatestringobligatorio

Valores permitidos:coregenerative-ai

mutabilitystringobligatorio

Valores permitidos:readexternal-readwriteexternal-write

namestringobligatorio

Valores permitidos:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListwhatsappContactListwhatsappTemplateListwhatsappMediaListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsToolgenerateVideoOptionsvideoFunctionToolgenerateVideoToolgenerateImageTooluploadFromUrlTool

scopesstring[]obligatorio

máx. de elementos: 4

titlestringobligatorio

longitud mín.: 1 · longitud máx.: 80

inputSchemaobjectobligatorio

Mostrar propiedades

typestringobligatorio

400

Solicitud no válida. No se aceptan parámetros de consulta. Los fallos de validación pueden usar el formato de error de la herramienta.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

401

Credencial bearer ausente, no válida o caducada.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

403

Las credenciales no tienen los permisos necesarios.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

404

La API o la herramienta solicitada no está disponible.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

429

Se ha superado el límite de solicitudes. Se puede reintentar.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

503

La API o el servicio que ejecuta la operación no está disponible.

errorobjectobligatorio

Mostrar propiedades

codestringobligatorio

messagestringobligatorio

retryablebooleanobligatorio

Solicitud

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

Respuesta

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