Ir al contenido

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

  • start depende de order (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)
  • limit es hasta 1000.
  • order puede ser uno de:
    • by_creator - ordenar por creador de la propuesta
    • by_start_date - ordenar por fecha de inicio de la propuesta
    • by_end_date - ordenar por fecha de fin de la propuesta
    • by_total_votes - ordenar por votos totales de la propuesta
  • order_direction puede ser uno de:
    • ascending
    • descending
  • status
    • all
    • inactive
    • active
    • expired
    • votable
start (array)limit (int)order (string)order_direction (string)status (string)
[""]10by_creatorascendingactiveenumera 10 propuestas con estado active, ordenadas por creador, en orden ascendente
["2019-08-07T16:54:03"]1000by_start_dateascendinginactiveenumera 1000 propuestas con estado inactive, ordenadas por fecha de inicio, en orden ascendente, desde 2019-08-07T16:54:03
["a"]1by_creatorascendingexpiredenumera 1 propuesta con estado expired, ordenada por creador, en orden ascendente, de cuentas que empiezan por "a"
["alice"]10by_creatorascendingallenumera 10 propuestas con cualquier estado, ordenadas por creador, en orden ascendente, de alice
[""]1000by_creatorascendingvotableenumera 1000 propuestas votables, ordenadas por creador, en orden ascendente
[10]1000by_total_votesascendingvotableenumera 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"
    }
  ]
}