Хаяг илрүүлэх ба заавар
connections.list() болон connections.capabilities(connection_id) нь connections:read эрх шаарддаг. Эдгээр нь ажлын орон зайн холболтууд болон хадгалсан хаягийн боломжийн мэдээллийг буцаана.
usage.get() нь usage:read эрх шаардаж, орон зайн багц болон credit үлдэгдлийг буцаана.
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 эрх шаарддаг. Үйлчилгээ үзүүлэгчийн боломж идэвхгүй бол хүсэлтийг татгалзана. Энэ хувилбарт нийтэд ашиглах үйлчилгээ үзүүлэгчийн үйлдлийн адаптер идэвхжээгүй.
operations.get(operation_id) нь operations:prepare эрх шаарддаг. operations.execute(operation_id), operations.cancel(operation_id) нь operations:execute эрх шаарддаг. Execute нь зөвхөн өмнө нь зөвшөөрсөн эсвэл товлосон үйлдлийг дараалалд оруулна; боловсруулагч төлөвийг нь шалгана. AI хэрэглэгчийн өмнөөс зөвшөөрөл өгөх боломжгүй.
Ижил зорилго, ижил өгөгдөлтэй үйлдлийг дахин оролдох үед л өмнөх idempotency key-г ашиглана. Бэлтгэсний дараа давхардсан үйлдэл үүсгэхийн оронд operation ID-г хадгалж, төлөвийг нь уншина.
Медианы амьдралын мөчлөг
media.create_upload(filename, content_type, sha256), media.complete_upload(media_id), media.get(media_id), media.delete(media_id) бүгд media:write эрх шаарддаг. Буцаасан 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 хүлээн авна. Эдгээр нь адаптерын түр хэрэгжилт тул items массив хоосон байх нь тухайн хаяг нийтлэлгүйг нотлохгүй.
analytics.get_aggregate(connection_id, start_date, end_date) нь analytics:read эрх шаардаж, хамгийн ихдээ 90 хоногийн зайтай ISO огноо хүлээн авна. Бодит үзүүлэлтийн оронд боломжгүй гэсэн төлөв буцаана.