Получение request_id при массовом добавлении сущностей.

[the-horhe]

Задача: массово добавить контакты, затем массово добавить к ним сделки.

Проблема на примере контактов:
$ids = $amo->contact->apiAdd($contactsArray);
Массив $ids будет содержать ID в AmoCRM, но нет возможности сопоставить элементы из $ids и $contactsArray.
Остаётся только добавлять контакты по одному, но их много, а количество запросов к API ограничено одним в секунду, после чего доступ к API закрывают и возвращают только по письму.

Возможное решение:
В API AmoCRM есть механизм, позволяющий побороть эту беду - параметр request_id, добавляемый к элементам в запросе будет продублирован в ответе.
Методы $xxx->apiAdd при обработке ответа API сейчас его не учитывают.

Мысли по реализации:

1. В методы apiAdd добавить опциональный параметр $raw = false и при значении true возвращать сырой response - быстро, не сломает обратную совместимость, но добавит веселья на стороне приложения.
2. В apiAdd добавить опциональный параметр callback - если передан в array_map использовать его.
3. Возвращать в ApiAdd модель ApiResponse с данными из ответа. Сложнее, ломает совместимость.