arztkonsultationarztkonsultation Docs
API referencev1.0.0Deutsch

POST/api/v1/s2s/partners/pharmacies/{partnerOrgId}/login-links

Create a one-time backoffice login link

Published Partner endpoint from the stable OpenAPI 1.0.0 contract.

Overview

Use this endpoint only with a Partner API key. Code samples use placeholders and the public sandbox URL.

Method
POST
Endpoint
/api/v1/s2s/partners/pharmacies/{partnerOrgId}/login-links
Authentication
X-API-Key

Request

Parameters

partnerOrgIdstring (uuid)pathRequired
Partner-controlled pharmacy identifier from the registration call.
Example: pharmacy-4711
X-Correlation-IDstringheader
Optional opaque request correlation ID for tracing API calls across systems. Billing audit paths persist only UUIDv4-shaped values and drop free-form values.
Example: 33333333-3333-4333-8333-333333333333

Request body

Required
userRefstring
Optional partner-stable user reference (max 128 chars, charset A-Za-z0-9._:@-). Without userRef the link targets the pharmacy owner backoffice user. An unknown userRef creates a restricted PHARMACY_STAFF backoffice user just in time (never an admin); the raw value is never persisted, only a hash.
Example: portal-user-77

Contract

The versioned OpenAPI contract is the authoritative source for parameters, request bodies, and response schemas.

Version

1.0.0

Expected response

201 Created

Download OpenAPI 1.0.0