Get an access token

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://content.doc.winkelstraat.nl/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "Content API MCP server": {
    "url": "https://content.doc.winkelstraat.nl/mcp"
  }
}

Close
POST /api/oauth/v1/retailer/token

Purpose: get an access token for all other endpoints. No token is needed to call this endpoint.

Required fields

  • Authorization header: Basic followed by the base64 encoding of client_id:secret. You receive the client ID and secret from Partner Success.
  • Body: {"grant_type": "password"} for a new token, or {"grant_type": "refresh_token", "refresh_token": "<refresh_token>"} to renew one. No username or password is needed.

Example: new token

curl -X POST https://content.winkelstraat.nl/api/oauth/v1/retailer/token \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic <base64 of client_id:secret>" \
  -d '{"grant_type": "password"}'

Example: renew a token

curl -X POST https://content.winkelstraat.nl/api/oauth/v1/retailer/token \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic <base64 of client_id:secret>" \
  -d '{"grant_type": "refresh_token", "refresh_token": "<refresh_token>"}'

Errors

When no token can be issued (wrong client ID or secret, or an invalid refresh token), the response contains "code": 422 and the message Failed to acquired retailer token instead of an access_token. Check the body for access_token: this error is currently returned with HTTP status 200.

Headers

  • Authorization string Required

    Basic <base64 of client_id:secret>

application/json

Body

  • grant_type string

    password for a new token, refresh_token to renew a token

    Values are password or refresh_token. Default value is password.

  • refresh_token string

    Required with grant_type refresh_token

Responses

  • 200 application/json

    An access token, or an error body (see the description)

    Hide response attributes Show response attributes object
    • access_token string

      Send this token on every request as Authorization: Bearer <access_token>

    • expires_in integer

      Validity of the token in seconds

    • token_type string

      Always bearer

    • scope string

      Not used

    • refresh_token string

      Use this to request a new access token when the current one has expired

    • code integer

      Only present on failure (422)

    • message string

      Only present on failure

POST /api/oauth/v1/retailer/token
curl \
 --request POST 'https://content.winkelstraat.nl/api/oauth/v1/retailer/token' \
 --header "Content-Type: application/json" \
 --header "Authorization: string" \
 --data '{
  "grant_type": "password"
}'
Request examples
# Headers
Authorization: string

# Payload
{
  "grant_type": "password"
}
Response examples (200)
{
  "access_token": "6f2a...e91c",
  "expires_in": 3600,
  "token_type": "bearer",
  "scope": null,
  "refresh_token": "9b7d...04af"
}
Response examples (200)
{
  "access_token": "string",
  "expires_in": 42,
  "token_type": "string",
  "scope": "string",
  "refresh_token": "string",
  "code": 42,
  "message": "string"
}