C / easybill REST API / Fetch a list of serial numbers for positions
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 *serial_number;
const char *position_id;
const char *id;
const char *document_id;
const char *document_position_id;
const char *used_at;
const char *created_at;
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>");
CkJsonObject_UpdateString(queryParams,"position_id","<string>");
CkJsonObject_UpdateString(queryParams,"document_id","<string>");
CkJsonObject_UpdateString(queryParams,"in_use","<boolean>");
CkHttp_SetRequestHeader(http,"Authorization","{{apiKey}}");
CkHttp_SetRequestHeader(http,"Accept","application/json");
resp = CkHttp_QuickRequestParams(http,"GET","https://api.easybill.de/rest/v1/serial-numbers",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": [
// {
// "serial_number": "<string>",
// "position_id": "<integer>",
// "id": "<long>",
// "document_id": "<long>",
// "document_position_id": "<long>",
// "used_at": "<string>",
// "created_at": "<string>"
// },
// {
// "serial_number": "<string>",
// "position_id": "<integer>",
// "id": "<long>",
// "document_id": "<long>",
// "document_position_id": "<long>",
// "used_at": "<string>",
// "created_at": "<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);
serial_number = CkJsonObject_stringOf(jResp,"items[i].serial_number");
position_id = CkJsonObject_stringOf(jResp,"items[i].position_id");
id = CkJsonObject_stringOf(jResp,"items[i].id");
document_id = CkJsonObject_stringOf(jResp,"items[i].document_id");
document_position_id = CkJsonObject_stringOf(jResp,"items[i].document_position_id");
used_at = CkJsonObject_stringOf(jResp,"items[i].used_at");
created_at = CkJsonObject_stringOf(jResp,"items[i].created_at");
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"
-d "position_id=%3Cstring%3E"
-d "document_id=%3Cstring%3E"
-d "in_use=%3Cboolean%3E"
-H "Authorization: {{apiKey}}"
-H "Accept: application/json"
https://api.easybill.de/rest/v1/serial-numbers
Postman Collection Item JSON
{
"name": "Fetch a list of serial numbers for positions",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/serial-numbers?limit=<integer>&page=<integer>&position_id=<string>&document_id=<string>&in_use=<boolean>",
"host": [
"{{baseUrl}}"
],
"path": [
"serial-numbers"
],
"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."
},
{
"key": "position_id",
"value": "<string>",
"description": "Filter serial numbers by position id."
},
{
"key": "document_id",
"value": "<string>",
"description": "Filter serial numbers by document id."
},
{
"key": "in_use",
"value": "<boolean>",
"description": "Filter serial numbers by usage."
}
]
}
},
"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}}/serial-numbers?limit=<integer>&page=<integer>&position_id=<string>&document_id=<string>&in_use=<boolean>",
"host": [
"{{baseUrl}}"
],
"path": [
"serial-numbers"
],
"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."
},
{
"key": "position_id",
"value": "<string>",
"description": "Filter serial numbers by position id."
},
{
"key": "document_id",
"value": "<string>",
"description": "Filter serial numbers by document id."
},
{
"key": "in_use",
"value": "<boolean>",
"description": "Filter serial numbers by usage."
}
]
}
},
"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 \"serial_number\": \"<string>\",\n \"position_id\": \"<integer>\",\n \"id\": \"<long>\",\n \"document_id\": \"<long>\",\n \"document_position_id\": \"<long>\",\n \"used_at\": \"<string>\",\n \"created_at\": \"<string>\"\n },\n {\n \"serial_number\": \"<string>\",\n \"position_id\": \"<integer>\",\n \"id\": \"<long>\",\n \"document_id\": \"<long>\",\n \"document_position_id\": \"<long>\",\n \"used_at\": \"<string>\",\n \"created_at\": \"<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}}/serial-numbers?limit=<integer>&page=<integer>&position_id=<string>&document_id=<string>&in_use=<boolean>",
"host": [
"{{baseUrl}}"
],
"path": [
"serial-numbers"
],
"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."
},
{
"key": "position_id",
"value": "<string>",
"description": "Filter serial numbers by position id."
},
{
"key": "document_id",
"value": "<string>",
"description": "Filter serial numbers by document id."
},
{
"key": "in_use",
"value": "<boolean>",
"description": "Filter serial numbers by usage."
}
]
}
},
"status": "Too Many Requests",
"code": 429,
"_postman_previewlanguage": "text",
"header": [
],
"cookie": [
],
"body": ""
}
]
}
