diff --git a/doc/REST-API-ru.md b/doc/REST-API-ru.md index f634392..647cc7f 100644 --- a/doc/REST-API-ru.md +++ b/doc/REST-API-ru.md @@ -221,6 +221,90 @@ deal: comments: ``` +#### Новая сделка (ордер) + +Ордер создается без указания адреса платежа (поле `payment`). Адрес платежа связан с исходными данными ордера. Зная исходные данные ордера можно вычислить адрес платежа. + +Адрес платежа создается модулем сделок. + +**Пример:** + +Минимально необходимый набор данных для создания ордера (в формате JSON) предоставлен ниже: + +Запрос: + +~~~http request +POST /api/v1/deal +~~~ + +Тело запроса +```json +{ + "order": "create", + "type": "Prepaid", + "at": "http://placard.zr-code.com", + "date": "2022-04-11 11:14:46 UTC", + "seller": { + "address": "n2f3cbeUUFhbz6mFLpDUzMnrt72sPu7WQK" + }, + "customer": { + "address": "2N3oefVeg6stiTb5Kh3ozCSkaqmx91FDbsm" + }, + "payment": { + "until": "2022-04-12 11:14:46 UTC", + "sum": 0.00001 + } +} +``` + +Ответ: + +~~~json +{ + "id": "AEEAB-PEE95-O6F30-S68A8-TC55A-O3B7D-L98370", + "action": "Created", + "result": { + "success": true, + "message": "New deal submitted" + }, + "payload": "LS0tLS1CRUdJTiBQR1AgU0lHTkVEIE1FU1NBR0UtLS0tLQpIYXNoOiBTSEE1MTIKCmRlYWw6CiAgb3JkZXI6IENyZWF0ZWQKICB0eXBlOiBQcmVwYWlkCiAgYXQ6IGh0dHA6Ly9wbGFjYXJkLnpyLWNvZGUuY29tCiAgZGF0ZTogMjAyMi0wNC0xMSAxMToxNDo0NiBVVEMKICBzZWxsZXI6CiAgICBhZGRyZXNzOiBuMmYzY2JlVVVGaGJ6Nm1GTHBEVXpNbnJ0NzJzUHU3V1FLCiAgICByYXRpbmc6IDAsIDAlCiAgY3VzdG9tZXI6CiAgICBhZGRyZXNzOiAyTjNvZWZWZWc2c3RpVGI1S2gzb3pDU2thcW14OTFGRGJzbQogICAgcmF0aW5nOiAwLCAwJQogIHBheW1lbnQ6CiAgICB1bnRpbDogMjAyMi0wNC0xMiAxMToxNDo0NiBVVEMKICAgIGFkZHJlc3M6IDJONmFidjNxaGdIUXh2bnRmRHptbWk0a0htMTRUYWRvQnB1CiAgICBzdW06IDAuMDAwMDEgdEJUQwogIGZlZWRiYWNrOgogICAgbGVhdmUtYmVmb3JlOiAyMDIyLTA0LTEyIDExOjE0OjQ2IFVUQwotLS0tLUJFR0lOIFBHUCBTSUdOQVRVUkUtLS0tLQpWZXJzaW9uOiBjYwoKd3B3RUFRRUtBQVlGQW1KVURid0FDZ2tRN0lqUjIwSkJpemVCckFRQWp0UlU5R3IySm1qdUhLTHhaejQrVWMzQwp2cUFzem1JcjhZRUdRUWZKS3o3SjJsd1U0ZkNOaVByZ29yQTdIdVRGa1Bqd0JrN0N0MHBOZlQwWmpxYTVYWXk5Cml1d01hRkVsM1dmVUQ0MlQxQVFWUDhCbUp6RmtxUXdVSE81dWtDS1RpaTViK3VHVVIvZzJETStFOXVBb3ZYWEYKZ3M5NldWVlJzNGg5YWdCektPTT0KPW4razcKLS0tLS1FTkQgUEdQIFNJR05BVFVSRS0tLS0t" +} +~~~ + +Расшифровка `payload`: + +~~~yaml +-----BEGIN PGP SIGNED MESSAGE----- +Hash: SHA512 + +deal: + order: Created + type: Prepaid + at: http://placard.zr-code.com + date: 2022-04-11 11:14:46 UTC + seller: + address: n2f3cbeUUFhbz6mFLpDUzMnrt72sPu7WQK + rating: 0, 0% + customer: + address: 2N3oefVeg6stiTb5Kh3ozCSkaqmx91FDbsm + rating: 0, 0% + payment: + until: 2022-04-12 11:14:46 UTC + address: 2N6abv3qhgHQxvntfDzmmi4kHm14TadoBpu + sum: 0.00001 tBTC + feedback: + leave-before: 2022-04-12 11:14:46 UTC +-----BEGIN PGP SIGNATURE----- +Version: cc + +wpwEAQEKAAYFAmJUDbwACgkQ7IjR20JBizeBrAQAjtRU9Gr2JmjuHKLxZz4+Uc3C +vqAszmIr8YEGQQfJKz7J2lwU4fCNiPrgorA7HuTFkPjwBk7Ct0pNfT0Zjqa5XYy9 +iuwMaFEl3WfUD42T1AQVP8BmJzFkqQwUHO5ukCKTii5b+uGUR/g2DM+E9uAovXXF +gs96WVVRs4h9agBzKOM= +=n+k7 +-----END PGP SIGNATURE----- +~~~ + ### Пользователь #### Помощь