גילוי כלים זמינים

מחזיר מידע על הכלים שגלויים לפרטי הגישה מסוג Bearer: שמות, תיאורים, הרשאות, דרישות אישור וסכמות קלט.

GET/api/v1/tools

הרשאה

Authorizationאסימון Bearer · headerחובה

מפתח API של Influence עם הרשאות מוגדרות, או אסימון גישה נתמך של OAuth. אל תכללו פרטי גישה בכתובות URL או בקלט לכלי.

תגובות

200

מתארי הכלים הזמינים.

toolsobject[]חובה

הצגת מאפיינים

מערך של object

annotationsobjectחובה

הצגת מאפיינים

destructiveHintbooleanחובה

idempotentHintbooleanחובה

openWorldHintbooleanחובה

readOnlyHintbooleanחובה

confirmationstringחובה

ערכים מותרים:nonerequired

descriptionstringחובה

אורך מזערי: 1 · אורך מרבי: 1024

gatestringחובה

ערכים מותרים:coregenerative-ai

mutabilitystringחובה

ערכים מותרים:readexternal-readwriteexternal-write

namestringחובה

ערכים מותרים:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

scopesstring[]חובה

מספר פריטים מרבי: 4

titlestringחובה

אורך מזערי: 1 · אורך מרבי: 80

inputSchemaobjectחובה

הצגת מאפיינים

typestringחובה

400

בקשה לא תקפה. פרמטרים בשאילתה אינם מתקבלים. כשלי בדיקת תקינות ברמת הכלי עשויים לחזור במעטפת שגיאה של כלי.

errorobjectחובה

הצגת מאפיינים

codestringחובה

messagestringחובה

retryablebooleanחובה

401

פרטי הגישה מסוג Bearer חסרים, אינם תקפים או שפג תוקפם.

errorobjectחובה

הצגת מאפיינים

codestringחובה

messagestringחובה

retryablebooleanחובה

403

לפרטי הגישה חסרות ההרשאות הנדרשות.

errorobjectחובה

הצגת מאפיינים

codestringחובה

messagestringחובה

retryablebooleanחובה

404

ממשק ה־API למערכות או הכלי המבוקש אינם זמינים.

errorobjectחובה

הצגת מאפיינים

codestringחובה

messagestringחובה

retryablebooleanחובה

429

חריגה ממגבלת קצב הבקשות. אפשר לנסות שוב.

errorobjectחובה

הצגת מאפיינים

codestringחובה

messagestringחובה

retryablebooleanחובה

503

ה־API או ביצוע הפעולה במערכת שעליה הוא מסתמך אינם זמינים.

errorobjectחובה

הצגת מאפיינים

codestringחובה

messagestringחובה

retryablebooleanחובה

בקשה

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

תגובה

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