Клиенты и цены

Кто пришёл

Каждый запрос клиента приходит к сервису с заголовком X-Looma-Client: это псевдоним, свой у каждого сервиса. Почты, имени и номера учётной записи сервис не получает. Свои учётные записи сервиса можно привязать к этому псевдониму.

from loomafloat import Looma, client_of

looma = Looma()
client = client_of(request.headers)        # None, если пришёл не клиент каталога

Цена за действие

Действия, за которые сервис берёт плату, объявляются в разделе events манифеста. Цена указывается в рублях, до копеек. Событие без цены бесплатное.

events:
  - { name: video, title: Ролик, note: по одной фразе, со звуком, price: 49 }
  - { name: edit, title: Правка, price: 2.5 }
  - answer

Поле	Что
`name`	имя события: латиница в нижнем регистре, цифры, `_` и `-`
`title`	подпись для клиента, до 60 знаков
`note`	пояснение к цене, до 80 знаков
`price`	цена одного события в рублях

Клиент видит цены на странице сервиса. В каталоге у карточки самая низкая цена: «49 ₽» или «от 2,5 ₽».

Отметьте действие

Когда действие сделано, отметьте событие для клиента:

looma.charge("video", client, id=job_id)

charge записывает действие на клиента. Если у события есть цена, в журнал ложатся расход клиента и доход автора. С id повтор не запишется дважды. Без SDK: POST $LOOMA_API_URL/charge с телом {"client", "event", "quantity", "id"} и токеном сервиса.

Вызовы моделей стоит тоже записывать на клиента: looma.for_client(client).chat(...). Тогда в статистике видно, сколько моделей потребил каждый клиент.

Доход

Раздел «Доход» в кабинете автора показывает по каждому сервису: число действий, начислено, комиссию площадки, себестоимость моделей и итог. Себестоимость считается по прайсу моделей на момент вызова. Выплат пока нет: раздел показывает учёт.