تأكيد عملية تعديل

أكد المدخلات المحضرة نفسها مع إرسال الترويستين المطلوبتين. تظل متطلبات المراجعة الإضافية للنشر والموافقة البشرية سارية. قد تتضمن استجابة 200 القيمة ok:false؛ ولا يعد قبول العمل أو جدولته دليلا على نشره. يقتصر حجم طلبات JSON على 65,536 بايت.

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

التفويض

Authorizationرمز Bearer · headerمطلوب

مفتاح API من Influence بصلاحيات محددة، أو رمز وصول OAuth مدعوم. لا تدرج بيانات الاعتماد في عناوين URL أو مدخلات الأدوات.

معاملات المسار

toolstringمطلوب

اسم الأداة الذي تعيده GET /api/v1/tools. تقتصر نتائج الاستكشاف على صلاحيات بيانات الاعتماد هذه؛ وجود المخطط لا يثبت إتاحة الأداة.

معاملات الترويسة

X-Publish-ConfirmationConfirmationCapabilityمطلوب

قيمة confirmationCapability نفسها التي أعادتها prepare. أرسلها في هذه الترويسة فقط، مع المدخلات نفسها، قبل expiresAt.

الطول الأدنى: 32 · الطول الأقصى: 4096 · يطابق ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyمطلوب

معرف لإعادة المحاولة ينشئه المستدعي. احتفظ بهذا المفتاح وقيمة confirmationCapability والمدخلات بعد أي استجابة غير مؤكدة.

الطول الأدنى: 16 · الطول الأقصى: 200 · يطابق ^[A-Za-z0-9._:-]+$

محتوى الطلب

مطلوبapplication/json

inputobjectمطلوب

الاستجابات

200

نتيجة الأداة؛ راجع ok وerror.

واحد فقط مما يلي:

object

okbooleanمطلوب

outputJsonValue | nullمطلوب

عرض الخصائص

واحد أو أكثر مما يلي:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

مصفوفة من JsonValue

مرجع دائري إلى JsonValue.

object

object

toolNamestringمطلوب

القيم المسموح بها:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

القيم المسموح بها:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringمطلوب

الطول الأدنى: 1 · الطول الأقصى: 2048

retryablebooleanمطلوب

okbooleanمطلوب

toolNamestringمطلوب

400

الطلب غير صالح. معاملات الاستعلام غير مقبولة. قد ترد أخطاء التحقق الخاصة بالأداة ضمن استجابة خطأ للأداة.

واحد أو أكثر مما يلي:

TransportError

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

retryablebooleanمطلوب

ToolError

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

الطول الأدنى: 1 · الطول الأقصى: 2048

retryablebooleanمطلوب

okbooleanمطلوب

toolNamestringمطلوب

401

بيانات اعتماد Bearer غير موجودة أو غير صالحة أو منتهية الصلاحية.

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

retryablebooleanمطلوب

403

بيانات الاعتماد لا تتضمن الصلاحيات المطلوبة.

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

retryablebooleanمطلوب

404

واجهة API المخصصة للبرامج أو الأداة المطلوبة غير متاحة.

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

retryablebooleanمطلوب

413

يتجاوز الطلب الحد الأقصى للبايتات.

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

الطول الأدنى: 1 · الطول الأقصى: 2048

retryablebooleanمطلوب

okbooleanمطلوب

toolNamestringمطلوب

429

جرى تجاوز حد معدل الطلبات. يمكن إعادة المحاولة بعد هذا الخطأ.

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

retryablebooleanمطلوب

503

واجهة API أو خدمة التنفيذ التي تعتمد عليها غير متاحة.

errorobjectمطلوب

عرض الخصائص

codestringمطلوب

messagestringمطلوب

retryablebooleanمطلوب

الطلب

curl -X POST 'https://influence.so/api/v1/tools/string/confirm' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Publish-Confirmation: stringstringstringstringstringst' \
  -H 'Idempotency-Key: stringstringstri' \
  -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/confirm", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "X-Publish-Confirmation": "stringstringstringstringstringst",
    "Idempotency-Key": "stringstringstri",
    "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/confirm",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "X-Publish-Confirmation": "stringstringstringstringstringst",
        "Idempotency-Key": "stringstringstri",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"input\": {\n    \"property1\": \"string\",\n    \"property2\": \"string\"\n  }\n}",
)

الاستجابة

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