Диадок API

Организации

GET /api/v1/diadoc/organizations/* — DiadocOrganizationControllerV1.

KeyValueStorage

POST /api/v1/diadoc/key-value-storage* — DiadocKeyValueStorageControllerV1.

Register — тело (JSON) { "thumbprint": "YOUR_CERT_THUMBPRINT" } RegisterConfirm — тело (JSON) { "thumbprint": "YOUR_CERT_THUMBPRINT", "dataToSign": "BASE64_FROM_REGISTER_RESPONSE", "signature": "BASE64_SIGNATURE" } SendFnsRegistrationMessage — тело (JSON) { "certificates": ["MIIIyjCCCHegAwIBAgIRAdD...Brfw=="] }

Ящик и подразделения

GET/POST /api/v1/diadoc/boxes, /departments — DiadocBoxControllerV1.

Сотрудники и пользователи

GET /api/v1/diadoc/employees, /users/* — DiadocEmployeeControllerV1, DiadocUserControllerV1.

Пользователь

GET /api/v1/diadoc/users/my/* — DiadocUserControllerV1.

Документы

GET /api/v1/diadoc/documents*, /document-types — DiadocDocumentControllerV1.

Документооборот V4

POST /api/v1/diadoc/docflows* — DiadocDocflowControllerV1. Для GetDocflows и PrepareToSign можно указать только messageId и entityId или JSON в блоке «Мутации» ниже.

Документооборот V5 (многотитульные)

POST /api/v1/diadoc/docflows/v5* — те же тела запросов, что и V4 (включая by-packet); ответы содержат DocumentInfoV5 и DocflowV5.

Сообщения

Контрагенты

События

Адреса ГАР

Технологический партнёр

GetPartnerEvents — тело запроса (JSON) { "documentDirections": ["Outbound"], "messageTypes": ["Letter"], "limit": 10 } PostRoamingNotification — тело (JSON) { "eventId": "event-uuid", "success": true, "description": "Доставлено", "messageId": "message-uuid", "notifiableEntityIds": ["entity-uuid"] }

Пересылка документов (Forwarding)

/api/v1/diadoc/forwarded-documents* — DiadocForwardingControllerV1 (obsolete в SDK).

GetForwardedDocuments — тело (JSON) { "forwardedDocumentIds": [{ "fromBoxId": "sender-box@diadoc.ru", "documentId": { "messageId": "msg-uuid", "entityId": "doc-entity-uuid" }, "forwardEventId": "forward-event-uuid" }], "injectEntityContent": false } ForwardDocument — тело (JSON) { "toBoxId": "recipient-box@diadoc.ru", "documentId": { "messageId": "msg-uuid", "entityId": "doc-entity-uuid" } } GetForwardedDocumentEvents — тело (JSON) { "filter": { "fromTimestamp": { "ticks": 0 }, "toTimestamp": { "ticks": 999999999999999999 } }, "populateForwardedDocuments": true, "injectEntityContent": false } GetForwardedEntityContent — query

DSS-подписание

POST /api/v1/diadoc/dss/sign* — DiadocDssControllerV1. После DssSign/DssSign V2 опрашивайте результат по taskId.

DssSign — тело запроса (JSON) { "files": [ { "content": { "content": "SGVsbG8=" }, "fileName": "hello.txt" } ] } CloudSign — тело запроса (JSON) { "files": [ { "content": { "content": "SGVsbG8=" }, "fileName": "hello.txt" } ] } CloudSignConfirm — token (из CloudSignResult) CloudSignConfirm — SMS-код DssSign V2 — тело запроса (JSON) { "files": [ { "content": { "nameOnShelf": "my-file.xml" }, "fileName": "doc.xml" } ], "signDataSource": "CertificateSign", "certificateData": { "thumbprint": "YOUR_THUMBPRINT" } }

Машиночитаемые доверенности (МЧД)

/api/v1/diadoc/powers-of-attorney* — DiadocPowerOfAttorneyControllerV1; привязка к сотруднику — /api/v1/diadoc/employees/{userId}/powers-of-attorney*. Для info/content укажите messageId и entityId в полях выше.

RegisterPowerOfAttorney — тело (JSON) { "fullId": { "registrationNumber": "00000000-0000-0000-0000-000000000000", "issuerInn": "1234567890", "representativeInn": "123456789012" }, "content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4=" } PrevalidatePowerOfAttorney — тело (JSON) { "fullId": { "registrationNumber": "00000000-0000-0000-0000-000000000000", "issuerInn": "1234567890", "representativeInn": "123456789012" }, "certificateThumbprint": "YOUR_THUMBPRINT" } Add/Delete EmployeePowerOfAttorney — тело (JSON) { "registrationNumber": "00000000-0000-0000-0000-000000000000", "issuerInn": "1234567890", "representativeInn": "123456789012" } UpdateEmployeePowerOfAttorney — тело (JSON) { "fullId": { "registrationNumber": "00000000-0000-0000-0000-000000000000", "issuerInn": "1234567890", "representativeInn": "123456789012" }, "isDefault": true }

Полка документов

GET/POST /api/v1/diadoc/shelves — DiadocShelfControllerV1.

Пофрагментная загрузка: query через поле Query — например fileExtension=.txt&isLastPart=false (init) или fileName=...&partIndex=1&isLastPart=true (part).

XML титулы и служебные документы

GenerateTitleXml / ParseTitleXml — query через поле Query: documentTypeNamedId, documentFunction, documentVersion, titleIndex. Для GenerateRevocationRequestXml добавьте contentTypeId=revocation_request_02; для SendDraft / шаблонов — operationId; для GenerateDocumentZip — fullDocflow=true.

Управление документами

Черновики

Шаблоны документов

Мутации (JSON)

Результат

Лог