Skip to content

Submit an upload​

POST
/data/api/v1/contribution-management/contribution

Applies a signed upload transaction. The body is the signed transaction as hex, as plain text. Do not wrap it in JSON quotes.

A record the company already holds active (same id and fraudType) is not stored and not rewarded again. tokenIds has one element per entry, in the order of the entries; for an entry that was already held it carries the id of the stored record.

The reward is paid per identifier: a range counts every value in it. The rate is the one of the uploader's company type (see the reward tables). For an entry with another company as sourcePeerId the reward is split between the two companies by the split ratio.

Every stored record takes one from the upload limit of the company. When the limit does not cover the records to store, the call answers 403 with code 79 and nothing is stored.

Sending the same signed transaction again within 30 days returns the first answer and changes nothing.

Authorizations​

bearerAuth

The accessToken of a sign-in or refresh answer. Valid for 5 minutes.

Type
HTTP (bearer)

Request Body​

text/plain
JSON
"04a1b2c3d4e5f60718293a4b5c6d7e8f04a1b2c3d4e5f60718293a4b5c6d7e8f"

Responses​

The upload is applied.

application/json
JSON
{
  
"status": {
  
  
"code": 0,
  
  
"name": "Ok"
  
},
  
"data": {
  
  
"tokenIds": [
  
  
  
{
  
  
  
  
"definitionId": "00000000-0000-7000-8000-000000000001#contribution",
  
  
  
  
"accountId": "admin@example_telco"
  
  
  
},
  
  
  
{
  
  
  
  
"definitionId": "00000000-0000-7000-8000-000000000002#contribution",
  
  
  
  
"accountId": "admin@example_telco"
  
  
  
},
  
  
  
{
  
  
  
  
"definitionId": "00000000-0000-7000-8000-000000000003#contribution",
  
  
  
  
"accountId": "admin@example_telco"
  
  
  
}
  
  
],
  
  
"rewarded": 120
  
}
}

Samples​

Powered by VitePress OpenAPI