Getting started
API Playground
Interactive API testing and exploration
API Playground
Test Geins APIs directly in your browser without writing any code.
GraphQL Playground (Merchant API)
The Merchant API uses GraphQL, which means you can explore the entire API schema and test queries interactively.
Using the Built-in Explorer
- Navigate to
https://merchantapi.geins.io/graphql - Add your API key header:
X-ApiKey: {MERCHANT_API_KEY} - Use the schema explorer to discover available queries and mutations
Sample Queries to Try
query {
products(take: 5) {
products {
productId
name
alias
}
}
}
query {
channels {
id
name
defaultLanguageId
defaultCurrencyId
}
}
query {
products(
first: 10
filter: { freeTextSearch: "shirt" }
) {
nodes {
id
name { texts { value } }
brand { name }
}
}
}
REST Explorer (Management API)
For the Management API, we recommend using:
- Postman — Import our Postman collection
- cURL — Quick command-line testing
- Your IDE — HTTP client extensions for VS Code, IntelliJ
Sample REST Calls
# List markets
curl 'https://mgmtapi.geins.io/API/Market/List' \
-H 'Authorization: Basic YOUR_CREDENTIALS' \
-H 'X-ApiKey: {MGMT_API_KEY}'
# Get product by ID
curl 'https://mgmtapi.geins.io/API/Product/123' \
-H 'Authorization: Basic YOUR_CREDENTIALS' \
-H 'X-ApiKey: {MGMT_API_KEY}'
Tools & Extensions
| Tool | API | Features |
|---|---|---|
| GraphQL Playground | Merchant | Schema explorer, auto-complete, history |
| Postman | Both | Collections, environment variables, tests |
| Insomnia | Both | GraphQL support, API design |
| VS Code REST Client | Both | In-editor HTTP requests |