Where to send edited file a OnlyOffice?


My version of OnlyOffice desktop not saves a file and show attention message about it. I use S3 storage presigned URLs as document.url:

    "type": "desktop",
    "documentType": "word",
    "token": null,
    "document": {
        "title": "pofailovoe_khranenie_relizov_dd2eb658-8fba-420c-ba7e-8aaf108be73b.docx",
        "url": "https://storage.yandexcloud.net/<bucket>/<s3_key>?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=<credential>&X-Amz-Date=20231123T091308Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1200&X-Amz-Signature=<Signature>",
        "fileType": "docx",
        "key": "ce27fcfe-cbc9-47a6-8fe7-bfe2ff8ed43b",
        "info": {
            "owner": "Unknown",
            "uploaded": "23.11.2023 09:13:08"
        "permissions": {
            "comment": true,
            "download": true,
            "edit": true,
            "fillForms": true,
            "modifyFilter": true,
            "modifyContentControl": true,
            "review": true
        "token": null
    "editorConfig": {
        "actionLink": null,
        "mode": "edit",
        "lang": "ru",
        "region": "ru-RU",
        "callbackUrl": "https://dev-delta.ligarobotov.ru/franchise/methodology/editor/track/?key=documents%2F2%2F1%2F1%2Fpofailovoe_khranenie_relizov_dd2eb658-8fba-420c-ba7e-8aaf108be73b.docx&type=2",
        "user": {...},
        "embedded": {
            "saveUrl": "https://storage.yandexcloud.net/<bucket>/<s3_key>?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=<credential>&X-Amz-Date=20231123T091308Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1200&X-Amz-Signature=<Signature>",
            "embedUrl": "https://storage.yandexcloud.net/<bucket>/<s3_key>?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=<credential>&X-Amz-Date=20231123T091308Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1200&X-Amz-Signature=<Signature>",
            "shareUrl": "https://storage.yandexcloud.net/<bucket>/<s3_key>?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=<credential>&X-Amz-Date=20231123T091308Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1200&X-Amz-Signature=<Signature>",
            "toolbarDocked": "top"
        "customization": {
            "about": true,
            "feedback": true,
            "compactHeader": true,
            "plugins": true,
            "compactToolbar": true,
            "goback": {
                "url": "https://dev-delta.ligarobotov.ru/franchise/meth-new/lessons/1"
        "canCoAuthoring": true,
        "canUseHistory": false,
        "canHistoryClose": false,
        "canHistoryRestore": false,
        "canSendEmailAddresses": false,
        "canRequestEditRights": true,
        "canRequestClose": false,
        "canRename": false,
        "canMakeActionLink": true,
        "canRequestUsers": false,
        "canRequestSendNotify": false,
        "canRequestSaveAs": false,
        "canRequestInsertImage": false,
        "canRequestMailMergeRecipients": false,
        "canRequestCompareFile": false,
        "canRequestSharingSettings": false,
        "canRequestCreateNew": false
    "width": "100%",
    "height": "100%",
    "events": {},
    "frameEditorId": "iframeEditor",
    "parentOrigin": "https://dev-delta.ligarobotov.ru"

I see message about I can’t save a file. Callback is never uses when I modify file and I not see any request in http access log. My questions is:

  • what a config parameter is address for uploading file?

  • how OnlyOffice test file save’s enable?

  • what contains (GET/POST/PUT params/body) a saving request?

Thanks for any help,

Hello @DEMo

First of all, please visit this page in How it works section of our API to find out how saving works in ONLYOFFICE Docs:

If I understand correctly, you are passing the direct link to the document in callbackUrl parameter. Please see this title about Callback Handler which is required for saving process in our API:

Hi, Constantine!

Sorry for late answer. No, callback handler pass to the PHP method what sends a new file version into S3. But I was not found a confirm in logs what had been a requests to callback URL on dev server.

Thanks for response,

I don’t quite follow this statement. Do you pass the document link to PHP script on your application side to save the file? If so, please check out documentation I’ve shared above again, as an independent integration you must implement Callback Handler that must return “error”:0 when successfully saving the file.

Examples of implementation of Callback Handler are also available in provided documentation:

Well. I don’t implement a {error:0} response to the callback PHP script and I will implement it. PHP script make upload link by key to saving file.


Thanks. I am not check callback address for exists and it fall document saving.


Did you manage to resolve the issue after all?


Yes. Thanks!

1 Like

I am glad to hear that. Good job!