{"openapi":"3.0.0","info":{"title":"Aansluitgegevens API","version":"1.0.0","description":"API voor het opvragen van aansluitgegevens met EAN-nummer"},"paths":{"/aansluitingen/{ean18Code}":{"get":{"summary":"Haal zakelijke aansluitgegevens op","description":"Retourneert aansluitgegevens op basis van EAN-18 code","parameters":[{"name":"ean18Code","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{18}$","example":"123456789012345678"},"description":"EAN-18 code van de aansluiting"}],"responses":{"200":{"description":"OK - Aansluitgegevens succesvol geretourneerd","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Aansluitgegevens"}}},"headers":{"X-Request-ID":{"description":"Unieke ID voor tracing","schema":{"type":"string","example":"req-123456"}}}},"400":{"description":"Bad Request - Ongeldige EAN-code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FoutAntwoord"},"example":{"status":400,"type":"https://api.voorbeeld.nl/fouten#bad-request","title":"Ongeldig verzoek","detail":"EAN-code moet 18 cijfers bevatten"}}}},"401":{"description":"Unauthorized - Authenticatie mislukt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FoutAntwoord"},"example":{"status":401,"type":"https://api.voorbeeld.nl/fouten#unauthorized","title":"Niet geautoriseerd","detail":"Ongeldig API-token"}}}},"403":{"description":"Forbidden - Geen toegangsrechten","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FoutAntwoord"},"example":{"status":403,"type":"https://api.voorbeeld.nl/fouten#forbidden","title":"Toegang geweigerd","detail":"Geen rechten voor deze aansluiting"}}}},"404":{"description":"Not Found - Aansluiting niet gevonden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FoutAntwoord"},"example":{"status":404,"type":"https://api.voorbeeld.nl/fouten#not-found","title":"Niet gevonden","detail":"Aansluiting met EAN-code '123456789012345678' bestaat niet"}}}},"422":{"description":"Unprocessable Entity - Semantische fouten","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FoutAntwoord"},"example":{"status":422,"type":"https://api.voorbeeld.nl/fouten#unprocessable-entity","title":"Onverwerkbaar verzoek","detail":"EAN-code is niet actief"}}}},"500":{"description":"Internal Server Error - Onverwachte fout","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FoutAntwoord"},"example":{"status":500,"type":"https://api.voorbeeld.nl/fouten#internal-error","title":"Interne serverfout","detail":"Databaseverbinding mislukt"}}}},"503":{"description":"Service Unavailable - Tijdelijk onbeschikbaar","headers":{"Retry-After":{"description":"Seconden tot herstel","schema":{"type":"integer","example":300}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FoutAntwoord"},"example":{"status":503,"type":"https://api.voorbeeld.nl/fouten#service-unavailable","title":"Service niet beschikbaar","detail":"Onderhoud tot 14:00 UTC"}}}}}}}},"components":{"schemas":{"Aansluitgegevens":{"type":"object","required":["uniekKenmerkBericht","EANCode","ATOStartdatum","KvKNummer","Postcode","Huisnummer","HuisnummerToevoeging","Straatnaam","Woonplaats"],"properties":{"uniekKenmerkBericht":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000","description":"Unieke ID van het bericht"},"EANCode":{"type":"string","pattern":"^\\d{18}$","example":"123456789012345678","description":"EAN-18 code van de aansluiting"},"ATOStartdatum":{"type":"string","format":"date","example":"2025-01-01","description":"Startdatum aansluitingsovereenkomst"},"KvKNummer":{"type":"string","pattern":"^\\d{8}$","example":"12345678","description":"KvK-nummer dienstverlener"},"Postcode":{"type":"string","pattern":"^[1-9][0-9]{3}[A-Za-z]{2}$","example":"1234AB","description":"Postcode zonder spatie"},"Huisnummer":{"type":"integer","minimum":1,"example":42,"description":"Huisnummer zonder toevoeging"},"HuisnummerToevoeging":{"type":"string","example":"A","description":"Huisnummertoevoeging (lege string indien geen toevoeging)"},"Straatnaam":{"type":"string","example":"Hoofdstraat","description":"Volledige straatnaam"},"Woonplaats":{"type":"string","example":"Amsterdam","description":"Officiële woonplaatsnaam"}}},"FoutAntwoord":{"type":"object","required":["status","title"],"properties":{"status":{"type":"integer","format":"int32","example":400},"type":{"type":"string","format":"uri","example":"https://api.voorbeeld.nl/fouten#bad-request"},"title":{"type":"string","example":"Ongeldig verzoek"},"detail":{"type":"string","example":"Verplicht veld ontbreekt"},"instance":{"type":"string","format":"uri","example":"/aansluitingen/123456789012345678"}},"additionalProperties":false}}},"servers":[{"description":"SwaggerHub API Auto Mocking","url":"https://virtserver.swaggerhub.com/personal-95f/01Aansluitinginformatie/1.0.0"}]}