Bir değişiklik hazırlayın

Bir değişikliği {input: {…}} ile hazırlayın. Hazırlık, yayını onaylamaz veya gerçekleştirmez. Başarılı hazırlık confirmationCapability ve expiresAt döndürür; araç hatası yine de HTTP 200 ile gelebilir. JSON isteklerinin sınırı 65.536 bayttır.

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

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

Hazırlık sonucu veya araç hatası.

En az biri:

PreparedTool

confirmationCapabilityConfirmationCapabilityzorunlu

Bu değeri expiresAt dolmadan X-Publish-Confirmation başlığında geri gönderin.

alt uzunluk sınırı: 32 · üst uzunluk sınırı: 4096 · şununla eşleşir: ^[A-Za-z0-9._~-]+$

expiresAtstring<date-time>zorunlu

şununla eşleşir: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

inputDigeststringzorunlu

şununla eşleşir: ^[0-9a-f]{64}$

statusstringzorunlu

summaryJsonValue | null

Ö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/prepare' \
  -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/prepare", {
  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/prepare",
    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

{
  "confirmationCapability": "stringstringstringstringstringst",
  "expiresAt": "2019-08-24T14:15:22Z",
  "inputDigest": "string",
  "status": "confirmation_required",
  "summary": "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
  }
}