database_api.list_proposals

Purpose

Возвращает все предложения (proposal), начиная с указанного создателя или даты начала. Параметры: start:array; limit:int; order:string; order_direction:string; status:string

• start зависит от order (см. ниже)
  • creator - создатель предложения (строка с именем аккаунта)
  • start_date - дата начала предложения (строка с датой)
  • end_date - дата окончания предложения (строка с датой)
  • total_votes - всего голосов у предложения (int)
• limit - до 1000.
• order может быть одним из:
  • by_creator - упорядочение по создателю предложения
  • by_start_date - упорядочение по дате начала предложения
  • by_end_date - упорядочение по дате окончания предложения
  • by_total_votes - упорядочение по числу голосов предложения
• order_direction может быть одним из:
  • ascending
  • descending
• status
  • all
  • inactive
  • active
  • expired
  • votable

start (array)	limit (int)	order (string)	order_direction (string)	status (string)
[""]	10	by_creator	ascending	active	список 10 предложений со статусом active, упорядоченных по создателю, по возрастанию
["2019-08-07T16:54:03"]	1000	by_start_date	ascending	inactive	список 1000 предложений со статусом inactive, упорядоченных по дате начала, по возрастанию, начиная с 2019-08-07T16:54:03
["a"]	1	by_creator	ascending	expired	список 1 предложения со статусом expired, упорядоченного по создателю, по возрастанию, по аккаунтам, начинающимся с "a"
["alice"]	10	by_creator	ascending	all	список 10 предложений с любым статусом, упорядоченных по создателю, по возрастанию, по alice
[""]	1000	by_creator	ascending	votable	список 1000 доступных для голосования (votable) предложений, упорядоченных по создателю, по возрастанию
[10]	1000	by_total_votes	ascending	votable	список 1000 доступных для голосования (votable) предложений, упорядоченных по создателю, по возрастанию, с не менее чем 10 голосами

См. также: Paginated API Methods

Parameters

PARAMETERS

{
  "start": null,
  "limit": 0,
  "order": "by_name",
  "order_direction": "ascending",
  "status": "all"
}

Example

Example 1

BASH

curl -s https://api.steemit.com \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "jsonrpc": "2.0",
    "method": "database_api.list_proposals",
    "params": {
      "start": [
        ""
      ],
      "limit": 10,
      "order": "by_creator",
      "order_direction": "ascending",
      "status": "active"
    },
    "id": 1
  }'

Example 2

BASH

curl -s https://api.steemit.com \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "jsonrpc": "2.0",
    "method": "database_api.list_proposals",
    "params": {
      "start": [
        "2019-08-07T16:54:03"
      ],
      "limit": 1000,
      "order": "by_start_date",
      "order_direction": "ascending",
      "status": "inactive"
    },
    "id": 1
  }'

Example 3

BASH

curl -s https://api.steemit.com \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "jsonrpc": "2.0",
    "method": "database_api.list_proposals",
    "params": {
      "start": [
        "a"
      ],
      "limit": 1,
      "order": "by_creator",
      "order_direction": "ascending",
      "status": "expired"
    },
    "id": 1
  }'

Example 4

BASH

curl -s https://api.steemit.com \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "jsonrpc": "2.0",
    "method": "database_api.list_proposals",
    "params": {
      "start": [
        "alice"
      ],
      "limit": 10,
      "order": "by_creator",
      "order_direction": "ascending",
      "status": "all"
    },
    "id": 1
  }'

Example 5

BASH

curl -s https://api.steemit.com \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "jsonrpc": "2.0",
    "method": "database_api.list_proposals",
    "params": {
      "start": [
        ""
      ],
      "limit": 1000,
      "order": "by_creator",
      "order_direction": "ascending",
      "status": "votable"
    },
    "id": 1
  }'

Example 6

BASH

curl -s https://api.steemit.com \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "jsonrpc": "2.0",
    "method": "database_api.list_proposals",
    "params": {
      "start": [
        10
      ],
      "limit": 1000,
      "order": "by_total_votes",
      "order_direction": "ascending",
      "status": "votable"
    },
    "id": 1
  }'

Response

RESPONSE

{
  "proposals": [
    {
      "id": 0,
      "proposal_id": "1103806595072",
      "creator": "alice",
      "receiver": "bob",
      "start_date": "2019-07-01T00:00:00",
      "end_date": "2019-08-01T23:59:59",
      "daily_pay": {
        "amount": "4800000",
        "precision": 3,
        "nai": "@@000000013"
      },
      "subject": "My Proposal",
      "permlink": "creator-proposal-permlink",
      "total_votes": "77351826710",
      "status": "active"
    }
  ]
}