Appeler un outil en lecture seule

Appelez un outil en lecture seule. Envoyez {input: {…}} selon le schéma de l’outil indiqué dans le chemin. Les requêtes JSON sont limitées à 65536 octets. Une réponse 200 peut contenir ok:false.

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

Autorisation

AuthorizationJeton Bearer · headerobligatoire

Clé API Influence avec des autorisations limitées ou jeton d’accès OAuth pris en charge. Ne placez jamais les identifiants dans les URL ni dans les données des outils.

Paramètres de chemin

toolstringobligatoire

Nom d’outil renvoyé par GET /api/v1/tools. La liste dépend des autorisations des identifiants ; la présence d’un schéma ne garantit pas la disponibilité.

Corps de la requête

obligatoireapplication/json

inputobjectobligatoire

Réponses

200

Résultat de l’outil ; vérifiez ok et error.

Une seule de:

object

okbooleanobligatoire

output__schema0obligatoire

Afficher les propriétés

__schema0

toolNamestringobligatoire

Valeurs autorisées :adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListwhatsappContactListwhatsappTemplateListwhatsappMediaListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsToolgenerateVideoOptionsvideoFunctionToolgenerateVideoToolgenerateImageTooluploadFromUrlTool

object

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

Valeurs autorisées :INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatoire

longueur min. : 1 · longueur max. : 2048

retryablebooleanobligatoire

okbooleanobligatoire

toolNamestringobligatoire

400

Requête non valide. Les paramètres de requête sont refusés. Les erreurs de validation peuvent utiliser l’enveloppe d’erreur d’un outil.

Une ou plusieurs de:

TransportError

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

ToolError

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

Valeurs autorisées :INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatoire

longueur min. : 1 · longueur max. : 2048

retryablebooleanobligatoire

okbooleanobligatoire

toolNamestringobligatoire

401

Identifiant bearer absent, non valide ou expiré.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

403

Les identifiants ne disposent pas des autorisations requises.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

404

L’API ou l’outil demandé est indisponible.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

413

La requête dépasse la limite en octets.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

Valeurs autorisées :INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatoire

longueur min. : 1 · longueur max. : 2048

retryablebooleanobligatoire

okbooleanobligatoire

toolNamestringobligatoire

429

Limite de requêtes dépassée. Une nouvelle tentative est possible.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

503

L’API ou le service chargé de l’exécution est indisponible.

errorobjectobligatoire

Afficher les propriétés

codestringobligatoire

messagestringobligatoire

retryablebooleanobligatoire

Requête

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éponse

{
  "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": "INVALID_INPUT",
    "message": "string",
    "retryable": true
  },
  "ok": false,
  "toolName": "adAuditQuote"
}

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

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