Biblioteka plików
Biblioteka plików wyświetla pliki źródłowe, wyniki zadań i pliki aplikacji, do których ma dostęp aktualne konto. Każdy element posiada stały identyfikator file_id i zwraca akcje, które wywołujący może obecnie wykonać.
Dokumenty używane jako wejście do tłumaczenia również posiadają punkty końcowe /api/v1/documents — lista, szczegółowe informacje, aktualizacja i usuwanie. document_id służy do tworzenia zadań przetwarzania; file_id — do zarządzania uprawnieniami na poziomie biblioteki oraz pobierania plików. Nie należy zakładać, że te dwa identyfikatory są wzajemnie zamienne.
Wylistuj i szczegółowo opisz
Dział zatytułowany „Wylistuj i szczegółowo opisz”GET /api/v1/storage/files?offset=0&limit=50GET /api/v1/storage/files/{file_id}Lista odpowiedzi:
{ "items": [ { "id": "x7m4q2k9n6c1v8pa", "name": "report.docx", "content_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "size_bytes": 45678, "status": "ready", "publication_status": "draft", "origin": { "product_code": "omnidoc-main", "display_name": "OmniDoc" }, "capabilities": { "can_view": true, "can_download": true, "can_update": true, "can_delete": true, "can_share": true }, "created_at": "2026-10-01T12:00:00Z", "updated_at": "2026-10-01T12:00:00Z" } ], "has_more": true, "next_offset": 50}Aby przejść do następnej strony, podaj next_offset jako offset; zatrzymaj się, gdy has_more będzie równe false.
Zawsze używaj capabilities każdego elementu, aby zdecydować, czy można go pobrać, udostępnić lub przyznać aplikacji; nie wyciągaj wniosków o uprawnieniach na podstawie pola origin.
Pobierz
Dział zatytułowany „Pobierz”GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content przekierowuje (302) na krótkotrwały adres pobierania; nie wysyłaj klucza API podczas przełączania się na ten adres. Zaleca się najpierw poprosić o download-ticket. Po wygaśnięciu poprzedniego adresu należy poprosić o nowy; nie przechowuj go.
Uprawnienia i linki
Dział zatytułowany „Uprawnienia i linki”GET /api/v1/storage/files/{file_id}/permissionsPOST /api/v1/storage/files/{file_id}/permissionsDELETE /api/v1/storage/files/{file_id}/permissions/{grant_id}
GET /api/v1/storage/files/{file_id}/linksPOST /api/v1/storage/files/{file_id}/linksDELETE /api/v1/storage/files/{file_id}/links/{link_id}Zmiany uprawnień i linki publiczne to oddzielne funkcje. Tworząc link, należy wyraźnie ustalić jego odbiorców, uprawnienia do pobierania, datę ważności oraz opcjonalną liczbę pobierań; anuluj go natychmiast po usunięciu potrzeby.
Widoki przestrzeni roboczej
Dział zatytułowany „Widoki przestrzeni roboczej”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsEndpointy przestrzeni roboczej są odpowiednie dla centrum plików; /storage/files obsługuje operacje uprawnień i pobierania na pojedynczym pliku.