Zum Inhalt
HALOWERK

Finopswerk

cost credit period ledger

Reconcile supplied cloud cost lines and retrospective credits across reporting periods without float drift. Caller-supplied normalized records only. No actual cloud account, tariff lookup or financial action. Unknown domain evidence remains unknown. A schema-valid unknown is a successful result at the same fixed price. Invalid input raises native HTTP400 before settlement.

POST https://finops.halowerk.com/v1/cost-credit-period-ledger

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
periodsarrayJa
linesarrayJa
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "periods": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{1,16}$"
          },
          "from": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4102444800
          },
          "to": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4102444800
          }
        },
        "required": [
          "id",
          "from",
          "to"
        ]
      },
      "minItems": 1,
      "maxItems": 6
    },
    "lines": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{1,16}$"
          },
          "from": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4102444800
          },
          "to": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4102444800
          },
          "currency": {
            "type": "string",
            "pattern": "^[A-Z]{3}$"
          },
          "amount_minor": {
            "type": "string",
            "pattern": "^-?(0|[1-9][0-9]{0,11})$"
          },
          "kind": {
            "enum": [
              "charge",
              "credit"
            ]
          },
          "credit_for": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{1,16}$"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "from",
          "to",
          "currency",
          "amount_minor",
          "kind"
        ]
      },
      "minItems": 1,
      "maxItems": 12
    }
  },
  "required": [
    "periods",
    "lines"
  ]
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "periods": [
    {
      "id": "A",
      "from": 0,
      "to": 5
    },
    {
      "id": "B",
      "from": 5,
      "to": 10
    }
  ],
  "lines": [
    {
      "id": "c",
      "from": 0,
      "to": 10,
      "currency": "USD",
      "amount_minor": "100",
      "kind": "charge"
    }
  ]
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-05, 03:23 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →