Menü der Dokumentation

Öffentliche API

Die Authentifizierung für die öffentliche API erfolgt über die API-Schlüssel. Informationen zum Erstellen eines API-Schlüssels finden Sie unter API-Schlüssel.

Aufruf der Endpunkte

Beim Aufruf der Endpunkte benötigt der Header x-api-key den API-Schlüssel.

Endpunkte 

Eingabewert

Rückgabewert

Ablehnung

Berechtigungsregelwerk auf Vertrag anwenden 

POST  

/_api/v1/:tenantId/:instanceId/permissions/rules/apply/:contractId 

null

{
    "status": "ok",
    "data": null,
    "error": null
}

HTTP-Statuscode 429

{
    "status": "error",
    "data": null,
    "error": {
        "message": "Permissions update for contract \":contractId\" was requested before. Please retry after (0-300) seconds.",
        "retryAfter": 0-300 (number)
    }
}

Vertrags-ID generieren 

POST  

/_api/v1/:tenantId/:instanceId/id-gen/id/generate 

Optional

{
    "configName": "config-name-goes-here"
}
{
    "status": "ok",
    "data": {
        "generatedId": "CM-00123" (string)
    },
    "error": null
}

HTTP-Statuscode 500

{
    "status": "error",
    "data": null,
    "error": {
        "message": "An error occurred while generating id for instance \":instanceId\" (looking for configName: \"foobar\")"
    }
}

Vertragslaufzeit berechnen 

GET 

/_api/v1/:tenantId/:instanceId/contracts/term/calculate 

Abfrageparameter

Abfrageparameter

Beispielwert (Typ)

contractStart

(Pflichtwert)

20230101 (Zahl, Format: YYYYMMDD)

dateOfObservation

20240617 (Zahl, Format: YYYYMMDD, Standardwert ist aktueller Tag)

periodAmount

12 (Zahl)

periodUnit

m (d,w,m,y)

periodFixEndDate

20231231 (Zahl, Format: YYYYMMDD)

extensionAmount

12 (Zahl)

extensionUnit

m (d,w,m,y)

openEnded

true (boolean)

cancellationAmount

12 (Zahl)

cancellationUnit

m (d,w,m,y)

endOption

EndOfMonth (EndOfContract, EndOfMonth, EndOfQuarter, EndOfHalfYear, EndOfYear)

{
    "status": "ok",
    "data": {
        "nextEnd": "2025-12-31",
        "nextTermination": "2024-12-31"
    },
    "error": null
}

HTTP-Statuscode 422

{
    "status": "error",
    "data": null,
    "error": {
      "message": "Validation Failed",
        "details": {
            "queryParameterName": {
                "message": "'queryParameterName' is required"
        	}
    	}
    }
}
{
    "status": "error",
    "data": null,
    "error": {
      "message": "Validation Failed",
        "details": {
            "queryParameterName": {
                "message": "should be one of the following; ['d','w','m','y']",
                "value": "n"
            }
        }
    }
}