LibreMoney

2. Основная часть

2.8. API (RestAPI)

Операции с клеймами (hallmarks)

Decode Hallmark

Декодирует клеймо узла.

Запрос

http://localhost:1400/api/decodeHallmark?
     hallmark=HEXSTRING

Где:

• HEXSTRING — значение клейма

Ответ

{
     "valid":        VALID,
     "weight":       WEIGHT,
     "host":         "HOSTIP",
     "account":      "ACCOUNT",
     "accountRS":    "ACCOUNTRS",
     "date":         "DATE"
}

Где:

• VALID — либо true (истина), либо false (ложь)
• WEIGHT — вес, присвоенный клейму
• HOSTIP — IP-адрес или имя домена, ассоциированные с клеймом
• ACCOUNT — номер аккаунта, ассоциированный с клеймом
• ACCOUNT номер аккаунта ассоциированный с заданным клеймом
• ACCOUNTRS адрес аккаунта в кодировке Reed-Solomon
• DATE — дата создания клейма, в формате yyyy-mm-dd

Пример

Запрос:

http://127.0.0.1:1400/api?
     requestType=decodeHallmark&
     hallmark=d67f03a47cd91fc...8b9e30f371a9fcc8f

Ответ:

{
     "valid":      true,
     "weight":     1000,
     "host":       "162.23.47.189",
     "account":    "LMA-5EGB-HKFP-NQUT-DKYFH",
     "accountRS":  "ACCOUNTRS",
     "date":       "2013-12-09"
}

Generate Hallmark

Генерирует клеймо узла.

Запрос

http://localhost:1400/api/markHost?
     secretPhrase=MY_SECRET&
     host=MY_HOST&
     weight=WEIGHT&
     date=CURRENT_DATE

Где:

• MY_SECRET — секретная фраза аккаунта, для которого на ноде создается клеймо. Должна быть URL-encoded.
• MY_HOST — имя хоста для узла, которую вы хотите "заклеймить"
• WEIGHT — вес, который вы хотели бы назначить ноде. Если на одном и том же аккаунте "заклеймены" более, чем одна нода, этот вес будет определен как (этот_вес/сумма_всех_весов)
• CURRENT_DATE — сегодняшняя дата, в формате yyyy-mm-dd

Ответ

{
     "hallmark":       "HEXSTRING"
}

Где:

• HEXSTRING — строка с закодированным клеймом (1856 байт)

Пример

Запрос:

http://localhost:1400/api/markHost?
     secretPhrase=MySuperSecretPasswordThatIsNotEasy&
     host=node23.nodesrus.com&
     weight=100&
     date=2014-01-01

Ответ:

{
     "hallmark":       "d67f03a47cd91fc1...fd49f66b462daa1f14ae8"
}