Error
A valid request URL is required to generate request examples{
"key": "shopify",
"name": "Shopify",
"category": "ecommerce",
"enabled": true,
"config": {
"shopDomain": "acme.myshopify.com",
"accessToken": "••••••",
"syncStock": true
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Integrations
Read one connector (connecteur)
Returns a single connector addressed by its stable key (the value from the list), with its config secrets masked (••••••). 404 when no connector carries the key. Read this before an update: the update MERGES your patch into the config, so start from the fields you see here.
GET
/
v1
/
integrations
/
{key}
Error
A valid request URL is required to generate request examples{
"key": "shopify",
"name": "Shopify",
"category": "ecommerce",
"enabled": true,
"config": {
"shopDomain": "acme.myshopify.com",
"accessToken": "••••••",
"syncStock": true
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Authorizations
Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.
Path Parameters
The connector's stable key, e.g. shopify (from the connector list).
Minimum string length:
1Response
The connector (secrets masked).