C / easybill REST API / List all versions of a given document
Back to Collection Items
#include <C_CkHttp.h>
#include <C_CkJsonObject.h>
#include <C_CkHttpResponse.h>
#include <C_CkStringBuilder.h>
void ChilkatSample(void)
{
HCkHttp http;
BOOL success;
HCkJsonObject queryParams;
HCkHttpResponse resp;
HCkStringBuilder sbResponseBody;
HCkJsonObject jResp;
int respStatusCode;
const char *created_at;
const char *document_id;
const char *id;
const char *reason;
int j;
int count_j;
const char *document_version_item_type;
const char *page;
const char *pages;
const char *limit;
const char *total;
int i;
int count_i;
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
http = CkHttp_Create();
queryParams = CkJsonObject_Create();
CkJsonObject_UpdateString(queryParams,"limit","<integer>");
CkJsonObject_UpdateString(queryParams,"page","<integer>");
CkHttp_SetRequestHeader(http,"Authorization","{{apiKey}}");
CkHttp_SetRequestHeader(http,"Accept","application/json");
resp = CkHttp_QuickRequestParams(http,"GET","https://api.easybill.de/rest/v1/documents/:id/versions",queryParams);
if (CkHttp_getLastMethodSuccess(http) == FALSE) {
printf("%s\n",CkHttp_lastErrorText(http));
CkHttp_Dispose(http);
CkJsonObject_Dispose(queryParams);
return;
}
sbResponseBody = CkStringBuilder_Create();
CkHttpResponse_GetBodySb(resp,sbResponseBody);
jResp = CkJsonObject_Create();
CkJsonObject_LoadSb(jResp,sbResponseBody);
CkJsonObject_putEmitCompact(jResp,FALSE);
printf("Response Body:\n");
printf("%s\n",CkJsonObject_emit(jResp));
respStatusCode = CkHttpResponse_getStatusCode(resp);
printf("Response Status Code = %d\n",respStatusCode);
if (respStatusCode >= 400) {
printf("Response Header:\n");
printf("%s\n",CkHttpResponse_header(resp));
printf("Failed.\n");
CkHttpResponse_Dispose(resp);
CkHttp_Dispose(http);
CkJsonObject_Dispose(queryParams);
CkStringBuilder_Dispose(sbResponseBody);
CkJsonObject_Dispose(jResp);
return;
}
CkHttpResponse_Dispose(resp);
// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)
// {
// "page": "<integer>",
// "pages": "<integer>",
// "limit": "<integer>",
// "total": "<integer>",
// "items": [
// {
// "created_at": "<dateTime>",
// "document_id": "<long>",
// "id": "<long>",
// "items": [
// {
// "document_version_item_type": "zugferd1",
// "id": "<long>"
// },
// {
// "document_version_item_type": "xrechnung2_3_xml",
// "id": "<long>"
// }
// ],
// "reason": "<string>"
// },
// {
// "created_at": "<dateTime>",
// "document_id": "<long>",
// "id": "<long>",
// "items": [
// {
// "document_version_item_type": "xrechnung2_3_xml",
// "id": "<long>"
// },
// {
// "document_version_item_type": "xrechnung3_0_xml",
// "id": "<long>"
// }
// ],
// "reason": "<string>"
// }
// ]
// }
// Sample code for parsing the JSON response...
// Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code
// Chilkat functions returning "const char *" return a pointer to temporary internal memory owned and managed by Chilkat.
page = CkJsonObject_stringOf(jResp,"page");
pages = CkJsonObject_stringOf(jResp,"pages");
limit = CkJsonObject_stringOf(jResp,"limit");
total = CkJsonObject_stringOf(jResp,"total");
i = 0;
count_i = CkJsonObject_SizeOfArray(jResp,"items");
while (i < count_i) {
CkJsonObject_putI(jResp,i);
created_at = CkJsonObject_stringOf(jResp,"items[i].created_at");
document_id = CkJsonObject_stringOf(jResp,"items[i].document_id");
id = CkJsonObject_stringOf(jResp,"items[i].id");
reason = CkJsonObject_stringOf(jResp,"items[i].reason");
j = 0;
count_j = CkJsonObject_SizeOfArray(jResp,"items[i].items");
while (j < count_j) {
CkJsonObject_putJ(jResp,j);
document_version_item_type = CkJsonObject_stringOf(jResp,"items[i].items[j].document_version_item_type");
id = CkJsonObject_stringOf(jResp,"items[i].items[j].id");
j = j + 1;
}
i = i + 1;
}
CkHttp_Dispose(http);
CkJsonObject_Dispose(queryParams);
CkStringBuilder_Dispose(sbResponseBody);
CkJsonObject_Dispose(jResp);
}
Curl Command
curl -G -d "limit=%3Cinteger%3E"
-d "page=%3Cinteger%3E"
-H "Authorization: {{apiKey}}"
-H "Accept: application/json"
https://api.easybill.de/rest/v1/documents/:id/versions
Postman Collection Item JSON
{
"name": "List all versions of a given document",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/documents/:id/versions?limit=<integer>&page=<integer>",
"host": [
"{{baseUrl}}"
],
"path": [
"documents",
":id",
"versions"
],
"query": [
{
"key": "limit",
"value": "<integer>",
"description": "Limited the result. Default is 100. Maximum can be 1000."
},
{
"key": "page",
"value": "<integer>",
"description": "Set current Page. Default is 1."
}
],
"variable": [
{
"key": "id",
"value": "<long>",
"description": "(Required) ID of document"
}
]
}
},
"response": [
{
"name": "Successful operation",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: apikey",
"key": "Authorization",
"value": "<API Key>"
}
],
"url": {
"raw": "{{baseUrl}}/documents/:id/versions?limit=<integer>&page=<integer>",
"host": [
"{{baseUrl}}"
],
"path": [
"documents",
":id",
"versions"
],
"query": [
{
"key": "limit",
"value": "<integer>",
"description": "Limited the result. Default is 100. Maximum can be 1000."
},
{
"key": "page",
"value": "<integer>",
"description": "Set current Page. Default is 1."
}
],
"variable": [
{
"key": "id"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [
],
"body": "{\n \"page\": \"<integer>\",\n \"pages\": \"<integer>\",\n \"limit\": \"<integer>\",\n \"total\": \"<integer>\",\n \"items\": [\n {\n \"created_at\": \"<dateTime>\",\n \"document_id\": \"<long>\",\n \"id\": \"<long>\",\n \"items\": [\n {\n \"document_version_item_type\": \"zugferd1\",\n \"id\": \"<long>\"\n },\n {\n \"document_version_item_type\": \"xrechnung2_3_xml\",\n \"id\": \"<long>\"\n }\n ],\n \"reason\": \"<string>\"\n },\n {\n \"created_at\": \"<dateTime>\",\n \"document_id\": \"<long>\",\n \"id\": \"<long>\",\n \"items\": [\n {\n \"document_version_item_type\": \"xrechnung2_3_xml\",\n \"id\": \"<long>\"\n },\n {\n \"document_version_item_type\": \"xrechnung3_0_xml\",\n \"id\": \"<long>\"\n }\n ],\n \"reason\": \"<string>\"\n }\n ]\n}"
},
{
"name": "Too Many Requests",
"originalRequest": {
"method": "GET",
"header": [
{
"description": "Added as a part of security scheme: apikey",
"key": "Authorization",
"value": "<API Key>"
}
],
"url": {
"raw": "{{baseUrl}}/documents/:id/versions?limit=<integer>&page=<integer>",
"host": [
"{{baseUrl}}"
],
"path": [
"documents",
":id",
"versions"
],
"query": [
{
"key": "limit",
"value": "<integer>",
"description": "Limited the result. Default is 100. Maximum can be 1000."
},
{
"key": "page",
"value": "<integer>",
"description": "Set current Page. Default is 1."
}
],
"variable": [
{
"key": "id"
}
]
}
},
"status": "Too Many Requests",
"code": 429,
"_postman_previewlanguage": "text",
"header": [
],
"cookie": [
],
"body": ""
}
]
}
