API-documentatie Pharma-Intelligence¶
Welkom bij de API's van Pharma-Intelligence. Via deze API's koppelt u uw eigen systeem aan ZAGIS, PharmaPortal en PiDentity.
-
ZAGIS
Prijzen, verbruik en GIP-data. Alleen beschikbaar voor licentiehouders van ZAGIS.
-
PharmaPortal
Offerteaanvragen, claims, contracten en meer. Alleen voor licentiehouders van PharmaPortal.
-
PiDentity
Universele identificatie van organisaties (PI-Code). Beschikbaar voor alle partijen.
Aan de slag¶
Elk product (ZAGIS, PharmaPortal, PiDentity) heeft een eigen basis-URL en eigen authenticatie. De onderstaande principes gelden voor alle API's; de details per product staan in de tabellen hieronder.
1. Vraag toegang aan¶
De ZAGIS- en PharmaPortal-API's zijn alleen beschikbaar voor licentiehouders. Neem tijdig contact met ons op via info@zagis.nl. Wij:
- zetten testdata voor u klaar;
- voorzien u van een API-key;
- plaatsen uw server-IP op de whitelist.
PiDentity is openbaar en vereist geen toegangsaanvraag.
2. Basis-URL's per product¶
| Product | Test | Productie |
|---|---|---|
| ZAGIS | https://demo.zagis.nl |
https://www.zagis.nl |
| PharmaPortal | https://demo.pharma-portal.nl |
https://www.pharma-portal.nl |
| PiDentity | https://pidentity.pharma-intelligence.nl |
https://pidentity.pharma-intelligence.nl |
3. Authenticatie per product¶
| Product | Beveiliging | Headers |
|---|---|---|
| ZAGIS | IP-whitelisting + API-key + HMAC | x-zagis-key, x-zagis-hmac |
| PharmaPortal | IP-whitelisting + API-key | x-portal-key |
| PiDentity | Geen (openbaar) | Niet van toepassing |
Zie HMAC berekenen voor voorbeeldcode (Python, PHP, C#, Node.js, Java) om de vereiste HMAC-header te genereren.
4. Statuscodes¶
Alle endpoints gebruiken dezelfde conventie:
| Code | Betekenis |
|---|---|
200 |
Correct verwerkt request. |
401 |
Foutieve authenticatie of HMAC. |
Testen
Wilt u een ZAGIS- of PharmaPortal-integratie testen? Neem tijdig contact op via info@zagis.nl, dan zetten wij testdata en een API-key voor u klaar.