URI Template API
Breid URI-sjablonen (RFC 6570) uit — de standaard gebruikt door GitHub, OpenAPI/Swagger, HAL en vele hypermedia-API's — om URL's te bouwen vanuit een sjabloon en een set variabelen. Het expand-eindpunt neemt een sjabloon zoals /users/{user}{?page,per_page} en een JSON-object van variabelen, en retourneert de voltooide URI met alles correct percent-gecodeerd. Het implementeert alle vier niveaus van de specificatie: eenvoudige expansie {var}; gereserveerde {+var} en fragment {#var} expansie; de label {.var}, pad {/var}, pad-stijl-parameter {;var}, query {?var} en query-vervolg {&var} operatoren; meerdere variabelen {x,y}; en de waarde-modifiers — prefix {var:3} (eerste N karakters) en explode {var*} (lijsten en kaarten element voor element uitbreiden). Variabelen kunnen strings, lijsten of associatieve kaarten zijn. Het parse-eindpunt inspecteert een sjabloon en geeft de expressies, operatoren en variabelenamen weer. Alles wordt lokaal en deterministisch berekend, dus het is direct en privé. Ideaal voor REST- en hypermedia-cliënten, API-SDK's en codegeneratoren, OpenAPI-tooling en linkbuilding. Pure lokale berekening — geen sleutel, geen externe dienst, direct. Live, niets opgeslagen. 3 eindpunten. Dit breidt URI-sjablonen uit; voor het bouwen of parsen van queryreeksen gebruik een query-string API en voor het canonicaliseren van URL's gebruik een URL API.
api.oanor.com/uritemplate-api