01/04/2016

API деятельности в AutoCAD I/O API - Часть 2

Чтобы обновить активность

PUT autocad.io/us-east/v2/Activities('{my_id}')

Обновите деятельность. Деятельность должна существовать. Следующий запрос добавляет описание этой деятельности.

Пример успешного запроса:

PUT /autocad.io/us-east/v2/Activities('CreateALine') HTTP/1.1
Content-Type: application/json
Authorization: Bearer my_token
Host: autocad.io
Content-Length: 488
 
{
      "AppPackages":[],"HostApplication":"","RequiredEngineVersion":"20.1","Parameters":{
      "InputParameters":[
        {
          "Name":"HostDwg","LocalFileName":"$(HostDwg)"
        }
      ],"OutputParameters":[
        {
          "Name":"Result","LocalFileName":"result.dwg"
        }
      ]
    },"Instruction":{
      "CommandLineParameters":null,"Script":"_tilemode 1 _line 0,0 1,1  _save result.dwg\n"
    },"AllowedChildProcesses":[
    ],"IsPublic":false,"Id":"CreateALine","Version":1,"Description":"This Activity draws a line between (0,0) and (1,1)."
}

Пример успешного ответа:

Код - HTML: [Выделить]

HTTP/1.1 204 No Content
Cache-Control: no-cache
Date: Mon, 12 May 2014 23:43:20 GMT
Expires: -1
Pragma: no-cache
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
Connection: keep-alive

Заголовки запроса

Заголовок запроса	Описание
Тип содержимого	– application/x-www-form-urlencoded
Авторизация	- Предъявитель my_token

Примечание: Если Put завершается успешно, он возвращает "204 No Content". В противном случае, вы получите другой статус ошибки.

PATCH autocad.io/us-east/v2/Activities('{my_id}')

Обновите деятельность. Деятельность должна существовать. В следующем запрос меняет сценарий, чтобы нарисовать линию от (0,0) до (3,3).

Пример успешного запроса:

Код - HTML: [Выделить]

PATCH /autocad.io/us-east/v2/Activities('CreateALine') HTTP/1.1
Content-Type: application/json
Authorization: Bearer my_token
Content-Length: 135
 
{"Instruction":{
   "CommandLineParameters":null,"Script":"_tilemode 1 _line 0,0 3,3  _save result.dwg\n"
   }
}

Заголовки запроса
Тип содержимого – application/x-www-form-urlencoded Авторизация – Bearer my_token

Пример успешного ответа:

Код - HTML: [Выделить]

HTTP/1.1 204 No Content
Cache-Control: no-cache
Date: Mon, 12 May 2014 18:36:51 GMT
Expires: -1
Pragma: no-cache
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
Connection: keep-alive

Примечание: При Patch успешно выполняется, он возвращает "204 No Content". В противном случае, вы получите другой статус ошибки.

Удалить деятельность

DELETE autocad.io/us-east/v2/Activities('{my_id}')

Удалить конкретную деятельность

Пример успешного запроса:

Код - HTML: [Выделить]

DELETE /autocad.io/us-east/v2/Activities('CreateALine') HTTP/1.1
Authorization: Bearer my_token

Пример успешного ответа:

Код - HTML: [Выделить]

HTTP/1.1 204 No Content
Cache-Control: no-cache
Date: Mon, 12 May 2014 19:03:40 GMT
Expires: -1
Pragma: no-cache
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
Connection: keep-alive

Заголовки запроса

Заголовок запроса	Описание
Авторизация	- Предъявитель my_token

Примечание: Если Delete выполняется успешно, он возвращает "204 No Content". В противном случае, вы получите другой статус ошибки.

Получить старые версии

GET autocad.io/us-east/v2/Activities('{my_id}')/Operations.GetVersions

Получить все старые версии о деятельности. Если вы обновили активность, вы увидите предыдущие данные, называя это API.

Пример успешного запроса:

Код - HTML: [Выделить]

GET /autocad.io/us-east/v2/Activities('CreateALine')/Operations.GetVersions HTTP/1.1
Authorization: Bearer my_token

Пример успешного ответа:

Код - HTML: [Выделить]

HTTP/1.1 200 OK
Cache-Control: no-cache
Content-Type: application/json; odata.metadata=minimal; charset=utf-8
Date: Wed, 20 May 2015 16:46:01 GMT
Expires: -1
Pragma: no-cache
Server: Microsoft-IIS/8.5
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
Content-Length: 2066
Connection: keep-alive
 
{
  "@odata.context":"https://developer.api.autodesk.com/autocad.io/us-east/v2/$metadata#Activities","value":[
        {
          "AppPackages":[
 
          ],"HostApplication":"","RequiredEngineVersion":"20.1","Parameters":{
                "InputParameters":[
                  {
                        "Name":"HostDwg","LocalFileName":"$(HostDwg)"
                  }
                ],"OutputParameters":[
                  {
                        "Name":"Result","LocalFileName":"result.dwg"
                  }
                ]
          },"Instruction":{
                "CommandLineParameters":null,"Script":"_tilemode 1 _line 0,0 1,1  _save /result.dwg\n"
          },"AllowedChildProcesses":[
 
          ],"IsPublic":false,"Id":"CreateALine","Version":1,"Timestamp":"2015-05-20T00:29:00.496Z","Description":""
        },{
          "AppPackages":[
 
          ],"RequiredEngineVersion":"20.1","Parameters":{
                "InputParameters":[
                  {
                        "Name":"HostDwg","LocalFileName":"$(HostDwg)"
                  }
                ],"OutputParameters":[
                  {
                        "Name":"Result","LocalFileName":"result.dwg"
                  }
                ]
          },"Instruction":{
                "CommandLineParameters":null,"Script":"_tilemode 1 _line 0,0 1,1  _save /result.dwg\n"
          },"AllowedChildProcesses":[
 
          ],"IsPublic":false,"Id":"CreateALine","Version":3,"Timestamp":"2015-05-20T00:32:23.26Z","Description":"This Activity draws a line between (0,0) and (1,1)."
        }
  ]
}

Для установки деятельности текущий или конкретной версии

POST autocad.io/us-east/v2/Activities('{my_id}')/Operations.SetVersion

Установить деятельность указанной версии. По умолчанию, текущая версия которую клиент может видеть, всегда является последней версией. Но вы можете использовать этот API для отката плохого обновления. Этот API запрашивает номер версии в теле запроса HTTP.

Пример успешного запроса:

Код - HTML: [Выделить]

POST /autocad.io/us-east/v2/Activities('CreateALine')/Operations.SetVersion HTTP/1.1
Authorization: Bearer my_token
    Content-Length: 13
 
    {"Version":1}

Пример успешного ответа:

Код - HTML: [Выделить]

HTTP/1.1 200 OK
Cache-Control: no-cache
Date: Wed, 20 May 2015 16:52:41 GMT
Expires: -1
Pragma: no-cache
Server: Microsoft-IIS/8.5
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
Content-Length: 0
Connection: keep-alive

Заголовки запроса

Заголовок запроса	Описание
Авторизация	- Предъявитель my_token

Чтобы удалить все старые версии

POST autocad.io/us-east/v2/Activities('{my_id}')/Operations.DeleteHistory

Этот API удаляет все старые версии. Выполнять это не рекомендуется. Вы захотите сохранить старые версии, которые можно вернуть. Этот API предназначен в основном для внутреннего использования.

Источник: https://developer.autodesk.com/api/autocadio/#activity-api

Автор перевода: Дмитрий Емельянов

Обсуждение: http://adn-cis.org/forum/index.php?topic=

Опубликовано 01.04.2016