Paŭlo Ebermann

**Current behavior** When I have a GET operation with a 202 response, Zally gives me a SHOULD violation with message "Operations should use well-understood HTTP status codes", pointing to [rule...

UI: group similar violations

1

## Current situation When validating large APIs, you often get many similar violations, just for different locations. In the UI this currently looks like this (Nakadi's API used as an...

The generator outputs interfaces which import stuff from other projects. For example, after using the `jaxrsinterfaces` generator, I had those imports: ``` package de.zalando.einkaufshelden.purchase_order.api.controller; import de.zalando.einkaufshelden.purchase_order.api.model.*; import io.swagger.annotations.*; import de.zalando.einkaufshelden.purchase_order.api.model.Problem;...

Changed host keys are annoying and undermine security → use host certificates

3

When running odd in a cloud environment (as it is supposed to), you will regularly have new instances (e.g. after a version upgrade or just because AWS feels it needs...

**Background** We had two stacks, one with 100% weight, and a broken one (failed deployment) with 0% weight. After deploying a third stack, we (our CD system) was switching traffic...

Make it easier to define link headers

1

[RFC 5988, section 5](https://tools.ietf.org/html/rfc5988#section-5) is defining the `Link`HTTP header. It is mainly used on responses to GET requests (but can happen on any kind of response), but can also be...

Best Practices for implementing APIs (on both client and server side)

1

**Background** During today's meeting, we discussed an issue that can happen with compatible API changes, when the client doesn't follow our guidelines strictly. Specifically, if a client does an update...

Improvements for Problem guideline (176)

8

We discovered that our current [guideline about problem/json](https://opensource.zalando.com/restful-api-guidelines/#176) is interpreted somewhat differently (both between guild members, and by other developers in the company). Some things to clarify (most related to...

Make rule 111 consistent to 109

2

* [Guideline 109](https://opensource.zalando.com/restful-api-guidelines/#109) describes a conservative approach to API design – servers are supposed to reject unknown properties in inputs. * [Guideline 111](https://opensource.zalando.com/restful-api-guidelines/#111) says that "servers _may_ reject requests whose...

# One-line summary Mention that event_stream.read|write scopes are not used > Zalando ticket : – ## Description This adds two lines to the API definition indicating that the nakadi.event_stream.read|write scopes...