Skip to content

Instantly share code, notes, and snippets.

@pieterb
pieterb / hal+json.yaml
Last active April 5, 2018 10:05
hal+json schema for swagger 2.0
$schema: "http://json-schema.org/draft-04/schema#"
title: "HAL Schema"
description: |
JSON Hypertext Application Language Version 8 Internet-Draft,
according to https://tools.ietf.org/html/draft-kelly-json-hal-08",
definitions:
HRef:
description: |
Its value is either a URI [RFC3986] or a URI Template [RFC6570]. If
the value is a URI Template then the Link Object SHOULD have a
@pieterb
pieterb / prototype.py
Created May 13, 2017 12:48
Python Prototype class
from copy import copy
from functools import wraps
import types
__all__ = ['Object']
class Object(object):
"""
Base prototype for prototypal object model in Python.
@pieterb
pieterb / noinspection.sh
Last active May 14, 2022 15:25
IntelliJ PyCharm noinspection classes
# Extracted using:
unzip -p "PyCharm CE.app/Contents/lib/resources_en.jar" com/jetbrains/python/PyBundle.properties |
grep -B1 INSP.NAME |
grep '^#' |
sed 's|Inspection||g' |
sed -e 's|# *|# noinspection |' |
sort
# noinspection PyAbstractClass
# noinspection PyArgumentEqualDefault
@pieterb
pieterb / Makefile
Last active January 16, 2018 09:32
Sphinx documentation template
# .PHONY: help server clean inv
RM = rm -rf
SPHINXOPTS =
SPHINXBUILD = sphinx-build
AUTOBUILD = sphinx-autobuild
SOURCEDIR = .
BUILDDIR = _build

API ontwerp voor SIA (voorstel versie: 2018-09-10)

Context: Het doorvoeren van API versionering vereist een aanpassing van de URL namespace van SIA. Hieronder staat een gestroomlijnde REST API voor integratie met externe systemen. Een doel wat in dit ontwerp is nagestreeft is om minder interne details zichtbaar te maken voor externe partijen.

Huidig ontwerp gebruikt engelse termen in de URL namespace, maar dat

kunnen we ook omzetten naar Nederlandse terminologie (zoals aanbevolen