REST API

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

Регистрация пользователя

POST /users

Form Params: email, passwordHash, nickname

Получить пользователя по email

GET /users?email=<email>

Есть optional параметр full (по дефолту false), который при значении true отдает так же orders и apps

Получить пользователя по id

GET /users/<id>

Есть optional параметр full (по дефолту true), который при значении false отдает короткую версию документа.

Формат XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<user id="1">
    <email>email</email>
    <nickname>nick</nickname>
    <password-hash>202cb962ac59075b964b07152d234b70</password-hash>
    <customer-account>30.0</customer-account>
    <developer-account>0.0.</developer-account>
    <orders>
        <order id="1">
            <title>title</title>
            <balance>20.0</balance>
            <approved>true</approved>
        </order>
        <order id="2">
            <title>title</title>
            <balance>20.0</balance>
            <approved>false</approved>
        </order>
    </orders>
    <app id="1">
        <secret>15e63936-cd75-4cb9-84ff-b0bc49d3e8a7</secret>
    </app>
    <roles>
        <role>DEVELOPER</role>
        <role>CUSTOMER</role>
    </roles>
</user>

Добавление роли

PUT /users/<id>

Form Params: role {CUSTOMER, DEVELOPER, ADMIN}

Примечание: добавить заказ можно только после добавление роли CUSTOMER, а приложение только после добавления роли DEVELOPER

Пополнение счета для заказов

PUT /user/<id>/customer-account

FormParam: amount

Приложения

Добавить приложение пользователю

POST /apps

Form Params: userId

Получить приложение

GET /apps/<id>

Перегенерировать secret

PUT /apps/<id>

Формат XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<app id="1">
    <secret>9580330d-2ff6-4769-bc44-fa0b9e0931f6</secret>
    <user-id>1</user-id>
</app>

Заказы

Создать заказ

POST /orders

Form Params: userId, title, body, balance, cpa

Получить заказ

GET /orders/<id>

Формат XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<order id="1">
    <title>title</title>
    <balance>20.0</balance>
    <user-id>1</user-id>
    <approved>true</approved>
</order>

Подтвердить заказ

PUT /ordes/<id>

Пользовательские действия

Получить список действий

GET /actions

QueryParams: offset, limit

Формат XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<actions>
    <action id="2">
        <performer-id>1</performer-id>
        <offer-id>2</offer-id>
        <done>false</done>
        <deleted>false</deleted>
        <creation-time>13 Sep 2011 19:32:56 GMT</creation-time>
    </action>
    <action id="1">
        <performer-id>1</performer-id>
        <offer-id>1</offer-id>
        <done>false</done>
        <deleted>false</deleted>
        <creation-time>13 Sep 2011 19:32:53 GMT</creation-time>
    </action>
</actions>

Подтвердить действие

PUT /actions/<id>

Удалить действие

DELETE /actions/<id>

Офферы

Получить офферы

GET /offers

QueryParams: app, extId, sig