Өөрийн API-ийн хэрэгслүүд
custom.read.<api_slug>.<tool_name>(...configured_inputs) нь custom:read эрх шаардаж, тохируулсан GET, HEAD endpoint-ийг шууд дуудна. custom.write.<api_slug>.<tool_name>(...configured_inputs, _idempotency_key) нь custom:write шаардаж, POST, PUT, PATCH, DELETE хүсэлтийг хүний зөвшөөрөлд бэлтгэнэ. Оролтын схемийг Хөгжүүлэгчийн API хэсэгт тохируулна. _idempotency_key нь 1–100 тэмдэгттэй мөр бөгөөд ижил хүсэлтийн дахин оролдлогод ижил байна.
Идэвхтэй хэрэгсэл credential-ийн орон зайд динамикаар харагдана. Бэлтгэсэн хүсэлт call ID, зөвшөөрлийн URL буцааж, нэвтэрсэн owner, admin, editor хүн яг хүсэлтийг хянаад нэг удаа илгээнэ. custom.calls.get(call_id) нь custom:write эрхээр төлөв, үр дүнг уншина. Тохиргоо хадгалах нь API хүсэлт илгээхгүй.
Хаяг илрүүлэх ба заавар
connections.list() болон connections.capabilities(connection_id) нь connections:read эрх шаарддаг. Эдгээр нь ажлын орон зайн холболтууд болон хадгалсан хаягийн боломжийн мэдээллийг буцаана.
media.upload_inline(filename, content_type, data_base64) нь media:write эрх шаардаж, object storage host руу холбогдож чадахгүй client-д зориулан 8 MB хүртэлх файлыг дуудлага дотроо хүлээн авна; том файлд media.create_upload хэвээр. media.get-ээр ready болтол шалгана.
usage.get() нь usage:read эрх шаардаж, багц (free, plus, pro эсвэл exclusive), credit үлдэгдэл, allowance бүрийн ашиглалт болон ашиглах үед татгалзагдах нөөцийг нэрлэсэн over_quota жагсаалтыг буцаана. Platform admin-ы promotion авсан workspace exclusive багцтай гэж харагдана: тухайн хугацаанд бүх commercial limit болон credit debit нээлттэй тул monthly_credits болон limit нь null, charges_waived_by/limits_waived_by нь promotion, safety_ceiling нь платформын хатуу дээд хязгаар.
docs.list(locale), docs.get(slug, locale), docs.get_image(slug) нь docs:read эрх шаарддаг. Эдгээр нь нэвтрэлттэй бүтээгдэхүүний зааврыг уншина. Харин нийтийн заавар /docs болон /llms-full.txt хаягаар түлхүүргүйгээр нээлттэй.
Бэлтгэл ба үйлдлийн төлөв
content.prepare_publish(connection_id, payload, idempotency_key), content.prepare_update(...), content.prepare_delete(...) нь operations:prepare эрх шаарддаг. Боломж идэвхгүй бол хүсэлтийг reason-той татгалзана. Нийтлэх payload: {"text", "link" (зөвхөн Facebook), "media": [{"id", "kind": image|video}], "scheduledFor"}; засах, устгах нь нийтэлсэн зүйлийн {"content_id"}-г авна. Facebook: нийтлэх, засах, устгах; Threads: нийтлэх, устгах; Instagram: зөвхөн media-тай нийтлэх. Нэмэлт "format" талбар: story (Instagram: 1 зураг эсвэл видео, caption-гүй; Facebook: 1 зураг) эсвэл reel (Instagram, 1 видео). analytics.get_content(connection_id, content_id) нь нэг зүйлийн lifetime insight, analytics.get_aggregate нь хугацааны нийт болон өдөр бүрийн утгыг буцаана.
operations.get(operation_id) болон operations.list(status, connection_id, limit, cursor) нь operations:prepare эрх шаарддаг; жагсаалтад dashboard, өөр client-ээр бэлтгэсэн болон товлосон үйлдлүүд орно. Provider татгалзах payload-ыг бэлтгэх үед invalid_payload-аар эхэлсэн алдаагаар буцаана. operations.execute(operation_id), operations.cancel(operation_id) нь operations:execute эрх шаарддаг. Execute нь зөвхөн өмнө нь зөвшөөрсөн эсвэл товлосон үйлдлийг дараалалд оруулна; боловсруулагч төлөвийг нь шалгана. AI хэрэглэгчийн өмнөөс зөвшөөрөл өгөх боломжгүй.
Амжилтгүй дуудлага {error: {code, message, retryable, actionable_by}} буцаана; code нь invalid_request, invalid_payload, not_found, capability_unavailable, insufficient_credits, reauth_required, permission_missing, rate_limited, provider_unavailable, unsupported_target, provider_rejected зэрэг. retryable true үед л дахин оролдоно. provider_message нь platform-ын анхны текст.
Ижил зорилго, ижил өгөгдөлтэй үйлдлийг дахин оролдох үед л өмнөх idempotency key-г ашиглана. Бэлтгэсний дараа давхардсан үйлдэл үүсгэхийн оронд operation ID-г хадгалж, төлөвийг нь уншина.
Медианы амьдралын мөчлөг
media.create_upload(filename, content_type, sha256), media.complete_upload(media_id), media.get(media_id), media.list_own(status, limit, cursor), media.delete(media_id) бүгд media:write эрх шаарддаг. media.list_own нь dashboard-оор оруулсан файлыг ч олно. Буцаасан storage эрхээр файлыг шууд илгээгээд, upload-ийг дуусгаж, шалгалтыг хүлээнэ. media.delete нь орон зайн төлөвийг өөрчилдөг тул энэ эрх зөвхөн унших зориулалттай биш.
Агуулга унших ба аналитик
content.list_own(connection_id, limit, cursor), content.get_own(connection_id, content_id) нь content:read эрх шаарддаг. list_own нь 1–25 хүртэл limit хүлээн авна. Facebook, Instagram, Threads болон YouTube холболтын боломж идэвхтэй бол provider-ийн бодит контентыг буцаана; боломжгүй бол шалтгааныг мэдээлнэ. Item бүр type (text, image, video, carousel, other), format (post, reel, story)-тай; provider-ийн анхны утга provider_kind-д үлдэнэ.
analytics.get_aggregate(connection_id, start_date, end_date, timezone) нь analytics:read эрх шаардаж, хамгийн ихдээ 90 хоногийн зайтай ISO огноо хүлээн авна. Provider-оос үл хамаарах summary, анхны metrics болон хүссэн огноо бүрд нэг өдрийн утга буцаана. Хэрэглэгчийн IANA timezone-ийг дамжуулна: тухайн бүсээр өдөр хувааж чадахгүй provider (Meta болон YouTube нь America/Los_Angeles өдрөөр тоолдог) өөрийн бүсийг timezone.applied-д заана, days[].start/end нь огноо бүр таны бүсийн аль цагийг хамрахыг харуулна. Боломжгүй үзүүлэлт deprecated_by_provider зэрэг reason-тэй. analytics.get_content(connection_id, content_id) нь нэг зүйлийн lifetime insight-ийг уншина. Амжилттай аналитик дуудлага 3 credit; үзүүлэлтийн боломж account болон provider-оос хамаарна. Зөвшөөрөл эсвэл үйлчилгээний алдааг тусад нь мэдээлнэ.
Сэтгэгдэл
comments.list(connection_id, since, post_id, limit, posts) нь content:read эрх болон холболтын comments.read боломж шаардана. Өөрийн сүүлийн постуудын сэтгэгдлийг постоор бүлэглэн 1 credit-ээр буцаана: provider мэдээлбэл is_own, answered_by_you, liked_by_you, hidden болон ref-тэй. since өгвөл зөвхөн шинэ сэтгэгдэл уншина. AI сэтгэгдлийг хариулт хэрэгтэй, like дарахад хангалттай, юу ч хэрэггүй гэж ангилна; юу ч автоматаар хийгдэхгүй.
comments.prepare_engagement(connection_id, actions, idempotency_key) нь operations:prepare эрх шаардана. Хэрэглэгч хүссэн үед л 50 хүртэлх {ref, type: reply|like|hide, text} үйлдлийг нэг operation, нэг зөвшөөрлийн холбоостой бэлтгэнэ. Хариулт бүр 1 credit; like болон нуух үнэгүй. Facebook: хариулт, like, нуух; Instagram, Threads, YouTube: хариулт, нуух. TikTok, X дэмжигдэхгүй. Хариулах, like, нуухыг owner эсвэл admin холболт бүр дээр асаана.