Register content-type?

[RichiH]

Do we need to register openmetrics/text or text/openmetrics somewhere? https://github.com/RichiH/OpenMetrics/issues/8

[satterly]

It should probably be "application/openmetrics".

See https://tools.ietf.org/html/rfc2046#section-4.5

[SuperQ]

@satterly The format is intended to be human readable text, not a binary format. But application might make sense.

[hollodotme]

IMO text/openmetrics makes sense. As @SuperQ said, it's a human-readable text format/standard and nothing application specific.

Media types should be registered at iana.org.
Here's the list of all text media types.

How to register a media type is explained in this RFC, where section 4.2.1 also says that a charset parameter must be added, if the charset is not laid out in the payload itself, like in text/xml.

So text/openmetrics; charset=utf-8 should do the job.

A registration template can be found in section 5.6

[satterly]

IMHO, it should be "application" not "text" because (emphasis added) ...

The "application" media type is to be used for discrete data which do
not fit in any of the other categories, and particularly for data to
be processed by some type of application program. This is
information which must be processed by an application before it is
viewable or usable by a user.

That it is utf-8 encoded (and mostly human readable) is neither here nor there. It is designed to be consumed by an application, though it can be understood by humans just as JSON or XML can.

XML is an good comparison because the XML mime type RFC defines three mime types ("application/xml", "application/xml-external-parsed-entity", and "application/xml-dtd") and they explicitly state in the introduction that "text/xml" is only an alias to the "application/xml" mime type.

[RichiH]

I am sure the rfc editors will give guidance on this once we are that far. I don't care too much what we get as long as it makes sense. Sent by mobile; please excuse my brevity.

…

[hollodotme]

Fair points, @satterly.
Sorry, didn't read the application section careful enough.

[SuperQ]

@satterly Thanks, application/xml is a great example.

What about application/openmetrics-text, to differentiate it from say application/openmetrics-proto.