Актуальное описание:

ORD_API-v49.docx

Планируемый релиз:

15.11.2024

Версия Дата релиза Изменения
v49 September 5, 2024 1. Добавлена возможность создания иностранных организаций через метод PATCH /data/contract/all ;
  1. Добавлены изменения в модель создания договоров ContractCreateModel
  2. Добавлены обязательные параметры при редактировании для моделей InvoiceItemStatisticsEditModel, CreativeStatisticsEditModel ;
  3. В модели редактирование договоров ContractEditModel исключён тип договора "саморекламный". | | v48 | May 24, 2024 | 1. Добавлен метод GET data/contract/duplicate/ByInn для проверки наличия договора в системе и в случае успешного поиска предоставлении к нему доступа
  4. В модель ContractViewModel добавлены параметры "customerOksm" и "executorOksm” | | v47 | April 3, 2024 | 1. Добавлен метод GET /data/initialContract/all/ByOrganizationId для поиска изначальных договоров по идентификаторам иностранных организаций
  5. В методе PATCH /data/creativeContent/v2/all уточнены примеры запросов на создание контента для разных типов креативов
  6. В модель ContractViewModel добавлены параметры "isDuplicate", "isEditable"
  7. В метод GET /data/creative/list/byUser добавлен параметр "isOnlyMine"
  8. Добавлен метод GET /data/organizationRef/byAlternativeInn для получения ID иностранной организации по альтернативному ИНН или регистрационному номеру. | | v46 | July 20, 2023 | 1. Добавлены модели CreativeStatistics
  9. Добавлены новые методы для передачи статистики непосредственно из под креативов CreativeStatistics (названия полей аналогичны InvoiceItemStatistics): ◦ PATCH /data/creativeStatistics/all ◦ DELETE /data/creativeStatistics/all ◦ PATCH /data/creativeStatistics/{id} ◦ DELETE /data/creativeStatistics/{id} ◦ GET /data/creativeStatistics/all/byCreative
  10. В модели Creative: ◦ добавлен параметр "SelfPromotionOrganizationId" необходимый для саморекламных креативов; ◦ изменена обязательность поля "InitialContractId". | | v45 | June 15, 2023 | 1. Актуализированы все модели View
  11. Добавлен новый параметр ExportError в сущности: Договоры, Акты, Креативы
  12. Добавлен в Get, Patch, Post методы для договоров новый параметр для посреднич. договоров "isAgentActingForPublisher". | | v44 | | Добавлен метод GET /data/creative/list/byUser для получения списка креативов, созданных пользователем. | | v43 | April 6, 2023 | 1. Выдача токена (erid) перенесена в методы загрузки медиаданных. Добавлены новые версии методов загрузки креативов и медиаданных PATCH /data/creative/v2/all и PATCH /data/creativeContent/v2/all. Так же методы POST creativeContent/files и POST creativeContent/all получили измененную возвращаемую модель, добавилось поле "erid". Отключение старых версий методов запланировано на 20.04.023
  13. Добавлен комментарий как правильно заполнять поле Описание при регистрации креатива.
  14. Метод PATCH /data/creativeContent/all снова принимает текстовые и графические медиаданные. Добавлено описание корректной отправки медиаданных.
  15. Добавлен метод для создания иностранных организаций POST /data/organizationRef/getOrCreate. | | v42 | January 31, 2023 | 1. Загрузка медиаданных креатива разделена по типам данных. Со следующего релиза(середина февраля) физические файлы должны передаваться отдельным методом:1.1 Добавлен метод POST /data/creativeContent/files для загрузки файлов1.2 Добавлен метод PUT /data/creativeContent/files для перезаписи файлов
  16. Метод PATCH /data/creativeContent/all будет принимать только текстовые медиаданные.
  17. В метод PATCH /data/contract/all добавлены параметры customerType и executorType. К следующему релизу(середина февраля) параметры будут обязательными при передаче customerinn и executorinn. Но передавать эти параметры нужно уже сейчас.
  18. В методе PATCH /data/platform/all для типа площадки InformationSystem(Информационная система) поле url стало необязательным.
  19. В методе PATCH /data/platform/all теперь возвращаем id ранее заведенной площадки при попытке зарегистрировать дубль. | | v41 | December 21, 2022 | 1. PATCH /data/contract/all - При заведении контракта с типом Intermediary параметр actionType стал обязательным, значение none удалено для этого типа.
  20. PATCH /data/creative/all - параметр description стал обязательным
  21. PATCH /data/creative/all - добавлены обязательные параметры isSocial и isNative
  22. PATCH /data/invoice/all - параметр customerRole - добавлено описание заполнения параметра
  23. PATCH /data/invoiceItemStatistics/all - добавлена логика заполнения параметров actualImpressionsCount, plannedImpressionsCount, totalAmount, amountPerShow при isNative = true 6. PATCH /data/platform/all - изменен формат передачи ****URL: передается домен, раздел сайта, конкретная страница или ссылка на приложение из стора. Обязательно с https:// и http://. | | v40 | October 5, 2022 | 1. Редактирование договора доступно ТОЛЬКО создателю.
  24. Код ОКВЭД должен соответствовать шаблону и содержать 4-6 знаков кода | | v39 | September 30, 2022 | Добавлен метод POST /data/creativeContent/all Метод используется для создания медиаданных креативов с передачей файлов. Метод должен передаваться после создания креатива. | | v38 | September 23, 2022 | 1. Методы Contract - Номер договора изменен на обязательный
  25. Методы Invoice - Номер акта изменен на обязательный
  26. Метод обновления контракта ContractEditModel – Добавлена возможность изменения статуса изначальный контракт из "false" на "true" | | v36 | September 13, 2022 | 1. Методы Creative - изменен тэг для отправки ссылки в ОРД. Тэг "url" будет выведен из метода к 30.09.2022. Передача ссылок теперь в массиве "urls"
  27. Методы Creative - изменен формат ответа, убран тэг "markedUrl". | | v35 | September 7, 2022 | 1. Изменены ContractEditModel и InvoiceItemEditModel, добавлен тэг для обновления: isInitialContract | | v34 | September 5, 2022 | 1. Добавлены уточнения по заполнению CreativeContent для разных форматов | | v33 | September 2, 2022 | 1. Изменено описание organizationId на необязательное в PlatformCreateModel
  28. Исключены методы удаления:
    1. DELETE /data/contract/all
    2. DELETE /data/contract/{id}
    3. DELETE /data/creative/all
    4. DELETE /data/creative/{id}
    5. DELETE /data/invoice/all
    6. DELETE /data/invoice/{id} | | v32 | September 1, 2022 | 1. исправлено описание обязательности параметров запроса для методов:
    7. GET /data/creativeContent/all/byCreative
    8. GET /data/contract/all/byOrganization
    9. GET /data/invoiceItem/all/byInvoice
    10. GET /data/invoiceItemStatistics/all/byInvoiceItem | | v31 | August 31, 2022 | В Акте добавлены новые обязательные тэги (customerRole и executorRole) | | V30 | August 31, 2022 | 1. Убран признак isSocial в креативе
  29. Убран тэг dspSideIdentifier в креативе (нужно теперь соотносить их просто по порядковому номеру, то есть тот что первым был на входе, тот первый и на выходе)
  30. Добавлен markedUrl при создании креатива | | v27 | August 31, 2022 | 1. Добавлены методы для работы с контрактами (метод GET /data/contract/list/byOrganization заменен на GET /data/contract/all/byOrganization) | | v25 | August 23, 2022 | 1. Запросы с использованием Token
  31. Изменен метод для получения идентификатора организации | | v23 | August 15, 2022 | 1. Статистика по акту теперь связана с invoiceItemId | | V21 | August 15, 2022 | 1. GET /data/initialContract/all/ByInn - новый метод поиска изначального контракта
  32. GET /data/contract/list/byOrganization - новый метод получения контракта организаций
  33. методы PUT заменены типом PATCH
  34. Добавлены методы удаления массивами
  35. GET /data/creativeContent/all/byCreative - новый метод для получения медиаданных креатива к ID креатива
  36. В акте удален тип violations, до уточнения от ЕРИР. | | v20 | | 1. POST /auth/changePassword - описан ответ с кодом 200
  37. Изменен параметр для передачи изначального договора - initialContractId
  38. Добавлены методы для получения информации об организации пользователя и договоров организации.
  39. PATCH /data/platform/all - обновлен формат | | v19 | | 1. POST /auth/signin/changePassword изменен на POST /auth/changePassword
  40. GET /data/firstContract изменен на GET /data/contract/firstContract
  41. GET /auth/signin/reset - удален
  42. В методы Invoice добавлен тэг тип акта - type | | v17 | | | | 111 | September 7, 2023 | 11 измен |