Onay gerektirmeyen bir aracı çağırın

Keşif tanımında confirmation: “none” bulunan bir aracı çağırın. Buna veri okuma ve zaten yetkilendirilmiş bir yüklemeyi sürdürme dahildir. Yoldaki araç adına uyan şemayla {input: {…}} gönderin. JSON isteklerinin sınırı 65.536 bayttır. 200 yanıtında ok:false bulunabilir.

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

Yetkilendirme

AuthorizationBearer erişim belirteci · headerzorunlu

İzinleri sınırlandırılmış Influence API anahtarı veya desteklenen OAuth erişim belirteci. Kimlik bilgilerini URL’lere veya araç girdisine koymayın.

Yol parametreleri

toolstringzorunlu

GET /api/v1/tools tarafından döndürülen araç adı. Keşif, bu kimlik bilgisinin izinlerine göre filtrelenir; şemanın bulunması kullanılabilirliği kanıtlamaz.

İstek gövdesi

zorunluapplication/json

inputobjectzorunlu

Yanıtlar

200

Araç sonucu; ok ve error alanlarını inceleyin.

Yalnızca biri:

object

okbooleanzorunlu

outputJsonValue | nullzorunlu

Özellikleri göster

En az biri:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Öğe türü JsonValue olan dizi

Döngüsel başvuru: JsonValue.

object

object

toolNamestringzorunlu

İzin verilen değerler:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

İzin verilen değerler:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringzorunlu

alt uzunluk sınırı: 1 · üst uzunluk sınırı: 2048

retryablebooleanzorunlu

okbooleanzorunlu

toolNamestringzorunlu

400

Geçersiz istek. Sorgu parametreleri kabul edilmez. Araç doğrulama hataları, araç hata yanıtı yapısında dönebilir.

En az biri:

TransportError

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

retryablebooleanzorunlu

ToolError

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

alt uzunluk sınırı: 1 · üst uzunluk sınırı: 2048

retryablebooleanzorunlu

okbooleanzorunlu

toolNamestringzorunlu

401

Eksik, geçersiz veya süresi dolmuş bearer kimlik bilgisi.

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

retryablebooleanzorunlu

403

Kimlik bilgisi gerekli izinlere sahip değil.

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

retryablebooleanzorunlu

404

Programatik API veya istenen araç kullanılamıyor.

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

retryablebooleanzorunlu

413

İstek, bayt sınırını aşıyor.

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

alt uzunluk sınırı: 1 · üst uzunluk sınırı: 2048

retryablebooleanzorunlu

okbooleanzorunlu

toolNamestringzorunlu

429

İstek sıklığı sınırı aşıldı. Bu hata için yeniden deneme yapılabilir.

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

retryablebooleanzorunlu

503

API kullanılamıyor veya işlem bağlı sistemde yürütülemiyor.

errorobjectzorunlu

Özellikleri göster

codestringzorunlu

messagestringzorunlu

retryablebooleanzorunlu

İstek

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

Yanıt

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

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

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