Zum Hauptinhalt springen

RKSV.Sign API

At it's core, the RKSV.Sign API uses the IATSSCD interface that is also internally used by the Middleware to communicate with Austrian signing devices and services.

The API is hosted with REST and WCF/SOAP endpoints, users can decide which one to use.

REST API

Endpoints

The REST API is hosted at the following endpoints:

info

Both of these endpoints offer a fully featured API documentation via Swagger, which also allows automatic client generation. The Swagger documentation is available at the following endpoints:

For C# users, we've also prepared a sample implementation of the API in the RKSV.Sign demo repository on GitHub.

Authentication

Like all our services, users of the RKSV.Sign API need to authenticate via CashboxID and Access Token, which can be obtained via the Portal. These values need to be included into each requests in the HTTP headers:

  • cashboxid: Unique ID of the cashbox, in GUID format
  • accesstoken: Secret token that is used to authenticate the request

Additionally to obtaining these values from the Portal, they're also returned once when creating the cashbox via our API.

Methods

The following methods are available:

Echo

POST /api/v0/iatsscd/echo\ The echo method can be used to test if the endpoint is available and the authentication parameters are correct. This method returns the exact same data that was sent in the request.

Sample request

{
"message": "string"
}

Sample response

{
"message": "string"
}

Sign

POST /api/v0/iatsscd/sign\ The sign method can be used to sign a receipt. The RKSV-compliant receipt data is passed as a Base64-encoded JSON object in the request body. The signature is returned Base64-encoded as a JSON object in the response body.

Sample request

{
"dataBase64": "string"
}

Sample response

{
"signedDataBase64": "string"
}

Certificate

GET /api/v0/iatsscd/certificate\ The certificate method is used to obtain the certificate of the RKSV.Sign service. The certificate is returned as a Base64-encoded JSON object in the response body.

Sample response

{
"certificateBase64": "string"
}

ZDA

GET /api/v0/iatsscd/zda\ The ZDA method is used to obtain the short sign of the certificate service operator of the RKSV.Sign service. The ZDA is returned as a JSON object in the response body.

Sample response

{
"zda": "string"
}

WCF API

The WCF API uses the same methods as described above. For easier usage, we've prepared a WSDL file that can be used to generate a client for the API. Similar to our REST examples, we've created a C#/.NET sample in our RKSV demo repository on GitHub.

Endpoints

The WCF API is hosted at the following endpoints: