Getting connected
Authentication
Use the consumer key and consumer secret sent to you by Medidenta. The same pair can access the endpoints enabled for your integration.
Your credentials
| Credential | HTTP Basic Auth field | Format |
|---|---|---|
| Consumer key | Username | ck_… |
| Consumer secret | Password | cs_… |
Your actual key pair will be sent personally by email. All credentials shown in these pages are placeholders. Store your pair in your server’s environment or secret configuration.
export MEDIDENTA_CONSUMER_KEY='ck_YOUR_CONSUMER_KEY'
export MEDIDENTA_CONSUMER_SECRET='cs_YOUR_CONSUMER_SECRET'Configure HTTP Basic Auth
Your HTTP client encodes consumer_key:consumer_secret and sends it in the Authorization header. Use the client’s built-in Basic Auth option where available.
Authorization: Basic <base64(consumer_key:consumer_secret)>
Accept: application/jsonOrder submissions also use Content-Type: application/json. Inventory is a GET request with no JSON body.
Postman configuration
- Create a request to
https://hub.medidenta.com/api/inventory.phpand select GET. - Open Authorization and select Basic Auth.
- Set Username to your consumer key and Password to your consumer secret.
- Optionally add
skuunder Params. Leave Params empty for your full assigned inventory. - Send the request. For orders, change the method to POST, use
/api/orders.php, and set Body → raw → JSON.
Permissions and catalog scope
| Key permission | Inventory GET | Orders POST |
|---|---|---|
| Read | Allowed, within your inventory scope | Not allowed |
| Write | Not allowed | Allowed for your assigned source |
| Read/Write | Allowed, within your inventory scope | Allowed for your assigned source |
A key must be active and not revoked. Inventory scope is configured per key: selected SKUs or explicitly all inventory. An empty selected-SKU list returns an empty catalog. Requesting a SKU outside your scope returns the same result as a missing SKU.
There is no token exchange, login endpoint, or source_id authentication parameter. Contact the Medidenta representative who supplied your credentials if you need a replacement key, access changes, or additional SKUs.