استكشاف الأدوات المتاحة

تعيد أسماء الأدوات المتاحة لبيانات اعتماد 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
  }
}