Skip to main content

Problem Details for HTTP APIs
draft-ietf-appsawg-http-problem-03

Yes

(Barry Leiba)

No Objection

(Alia Atlas)
(Alissa Cooper)
(Alvaro Retana)
(Brian Haberman)
(Deborah Brungard)
(Jari Arkko)
(Joel Jaeggli)
(Martin Stiemerling)
(Terry Manderson)

Note: This ballot was opened for revision 01 and is now closed.

Barry Leiba Former IESG member
Yes
Yes (for -01) Unknown

                            
Ben Campbell Former IESG member
Yes
Yes (2015-12-16 for -02) Unknown
Section 4 talks about how a problem type SHOULD resolve to HTML documentation. Is there ever a case where an API might be standardized to be used by multiple origin servers? Would each server host it's own documentation? Would the problem type be a relative URL under those circumstances? (You say it can be relative, but all the examples are fully qualified)

- 4, 2nd paragraph: "New problem types need to carefully
   consider..."
This is a pedantic nit, really a personal pet peeve: Designers of new problem types should consider this. I doubt the types themselves will :-)
Stephen Farrell Former IESG member
Yes
Yes (2015-12-11 for -02) Unknown
- 3.1: "SHOULD NOT automatically" de-ref the type URI. Hmm, under
what circumstances would it be reasonable for any code to
automatically de-ref the type URI? If none, then either
s/SHOULD/MUST/ or maybe s/automatically// 

- 3.1, last para: I'm sure this is a known thing, but I don't know
the answer, so I'll ask:-) If I send a request for URL
example.com/foo and am re-directed to example.net/bar, against which
of those is a relative URL in the problem detail evaluated?  I hope
the answer is example.net - if not, there could be some attack that
could be mounted but I've not got a concrete example to offer.

- 3.2, last para: should "media type" be "problem type" at the end?

- 4: "typically with the "http" scheme" - your examples are all
https, don't you mean https here too?
Alia Atlas Former IESG member
No Objection
No Objection (for -02) Unknown

                            
Alissa Cooper Former IESG member
No Objection
No Objection (for -02) Unknown

                            
Alvaro Retana Former IESG member
No Objection
No Objection (for -02) Unknown

                            
Brian Haberman Former IESG member
No Objection
No Objection (for -02) Unknown

                            
Deborah Brungard Former IESG member
No Objection
No Objection (for -02) Unknown

                            
Jari Arkko Former IESG member
No Objection
No Objection (for -02) Unknown

                            
Joel Jaeggli Former IESG member
No Objection
No Objection (for -02) Unknown

                            
Martin Stiemerling Former IESG member
No Objection
No Objection (for -02) Unknown

                            
Spencer Dawkins Former IESG member
(was Discuss, Yes) No Objection
No Objection (2016-01-07 for -02) Unknown
Thanks for helping me resolve my Discuss.
Terry Manderson Former IESG member
No Objection
No Objection (for -02) Unknown