Getting Started
Geins Management API is a RESTful api that powers your applications and helps you manage your Geins services. Geins provides an easy-to-use and scalable solution for managing all aspects of an online store, from product listings and customer information to order processing and payment transactions.
With this API, you can build custom applications and integrate with third-party systems, feeds, dashboards and other bussiness logic apps.
Getting started
Once you have created a Geins account, you can start using the Management API by creating an API User. You can create as many API users as you need. Each API user is connected to a specific account so you can keep track of operations and manage keys.
You can find all your API credentials in Geins Merchant Center.
Authentication
Basic Auth
A Basic auth Authorization header needs to be included in every request. The value should be Basic <credentials> where <credentials> is the Base64 encoding of your API username and API password joined by a single colon :.
See Wikipedia for more information on Basic auth.
API Key
A X-ApiKey header needs to be included in every request. This header should contain the value of your API key.
Generate Credentials Base64 Encoded
Generate Basic Auth Header
Request Example
curl -X GET 'https://mgmtapi.geins.io/API/Brand/{id}' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic [USER-CREDENTIALS-BASE64-ENCODED]' \
-H 'X-ApiKey: {MGMT_API_KEY}'
import axios from 'axios';
const config = {
method: 'GET',
url: 'https://mgmtapi.geins.io/API/Brand/{id}',
headers: {
Accept: 'application/json',
'Content-Type': 'application/json',
Authorization: 'Basic [USER-CREDENTIALS-BASE64-ENCODED]',
'X-ApiKey': '{MGMT_API_KEY}',
},
};
axios
.request(config)
.then((response) => response.data)
.catch((error) => console.error(error));
const response = await fetch('https://mgmtapi.geins.io/API/Brand/{id}', {
method: 'GET',
headers: {
Accept: 'application/json',
'Content-Type': 'application/json',
Authorization: 'Basic [USER-CREDENTIALS-BASE64-ENCODED]',
'X-ApiKey': '{MGMT_API_KEY}',
},
});
const data = await response.json();
console.log(data);
import requests
url = "https://mgmtapi.geins.io/API/Brand/{id}"
headers = {
'Accept': 'application/json',
'Content-Type': 'application/json',
'Authorization': 'Basic [USER-CREDENTIALS-BASE64-ENCODED]',
'X-ApiKey': '{MGMT_API_KEY}'
}
response = requests.GET(url, headers=headers)
print(response.json())
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
url := "https://mgmtapi.geins.io/API/Brand/{id}"
payload := []byte{}
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Accept", "application/json")
req.Header.Add("Content-Type", "application/json")
req.Header.Add("Authorization", "Basic [USER-CREDENTIALS-BASE64-ENCODED]")
req.Header.Add("X-ApiKey", "{MGMT_API_KEY}")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
using System.Text;
using System.Text.Json;
using System.Net.Http;
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Basic [USER-CREDENTIALS-BASE64-ENCODED]");
client.DefaultRequestHeaders.Add("X-ApiKey", "{MGMT_API_KEY}");
var response = await client.GETAsync("https://mgmtapi.geins.io/API/Brand/{id}", null);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);