database_api.list_proposals
Purpose
Devuelve todas las propuestas (proposal), empezando por el creador o la fecha de inicio especificados. Parámetros: start:array; limit:int; order:string; order_direction:string; status:string
startdepende deorder(ver más abajo)creator- creador de la propuesta (cadena con el nombre de cuenta)start_date- fecha de inicio de la propuesta (cadena de fecha)end_date- fecha de fin de la propuesta (cadena de fecha)total_votes- votos totales de la propuesta (int)
limites hasta 1000.orderpuede ser uno de:by_creator- ordenar por creador de la propuestaby_start_date- ordenar por fecha de inicio de la propuestaby_end_date- ordenar por fecha de fin de la propuestaby_total_votes- ordenar por votos totales de la propuesta
order_directionpuede ser uno de:ascendingdescending
statusallinactiveactiveexpiredvotable
start (array) | limit (int) | order (string) | order_direction (string) | status (string) | |
|---|---|---|---|---|---|
[""] | 10 | by_creator | ascending | active | enumera 10 propuestas con estado active, ordenadas por creador, en orden ascendente |
["2019-08-07T16:54:03"] | 1000 | by_start_date | ascending | inactive | enumera 1000 propuestas con estado inactive, ordenadas por fecha de inicio, en orden ascendente, desde 2019-08-07T16:54:03 |
["a"] | 1 | by_creator | ascending | expired | enumera 1 propuesta con estado expired, ordenada por creador, en orden ascendente, de cuentas que empiezan por "a" |
["alice"] | 10 | by_creator | ascending | all | enumera 10 propuestas con cualquier estado, ordenadas por creador, en orden ascendente, de alice |
[""] | 1000 | by_creator | ascending | votable | enumera 1000 propuestas votables, ordenadas por creador, en orden ascendente |
[10] | 1000 | by_total_votes | ascending | votable | enumera 1000 propuestas votables, ordenadas por creador, en orden ascendente, con al menos 10 votos |
Véase también: Paginated API Methods
Parameters
PARAMETERS
json
{
"start": null,
"limit": 0,
"order": "by_name",
"order_direction": "ascending",
"status": "all"
}Example
Example 1
BASH
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
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
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
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
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
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
json
{
"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"
}
]
}