WebRef (paid)

Look up an HTTP status code: what it means, what the client must do, whether it is retryable, whether it is safe to replay, the defining RFC and the common causes. ($0.003 per call)

{
  "type": "object",
  "properties": {
    "code": {
      "description": "status code, e.g. 429",
      "type": [
        "number",
        "string"
      ]
    },
    "detail": {
      "default": "full",
      "description": "summary = name and class only; decision = what the client should do",
      "type": "string",
      "enum": [
        "summary",
        "full",
        "decision"
      ]
    }
  },
  "required": [
    "code"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find the HTTP status code that matches a described situation, when the code is not known in advance — for example 'the caller is being rate limited' or 'upstream returned garbage'. ($0.005 per call)

{
  "type": "object",
  "properties": {
    "situation": {
      "type": "string",
      "description": "free text describing what went wrong"
    }
  },
  "required": [
    "situation"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Decide how a client should react to a status code: retry with backoff, check the outcome before retrying, or do not retry. Includes a suggested backoff schedule. ($0.005 per call)

{
  "type": "object",
  "properties": {
    "code": {
      "type": [
        "number",
        "string"
      ]
    },
    "idempotent": {
      "default": true,
      "description": "whether the request being handled is idempotent",
      "type": "boolean"
    }
  },
  "required": [
    "code"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Look up a MIME type by full type or by file extension: the top-level type, what it is for, and the usual file extension. ($0.003 per call)

{
  "type": "object",
  "properties": {
    "type": {
      "description": "full type, e.g. application/json",
      "type": "string"
    },
    "extension": {
      "description": "extension, with or without the dot",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List or search MIME types by top-level type or by keyword, for example image types or anything to do with calendars. ($0.003 per call)

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "topLevel": {
      "description": "application, text, image, audio, video, font, model, multipart, message, example",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check whether a Content-Type header matches what an endpoint kind expects, and say what to send instead when it does not. ($0.003 per call)

{
  "type": "object",
  "properties": {
    "contentType": {
      "type": "string",
      "description": "the Content-Type header value"
    },
    "endpointKind": {
      "type": "string",
      "enum": [
        "json",
        "form",
        "multipart",
        "xml",
        "text",
        "binary"
      ],
      "description": "what the endpoint expects"
    }
  },
  "required": [
    "contentType",
    "endpointKind"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Describe an HTTP method: whether it is safe, whether it is idempotent, whether it carries a body, and what it is for. ($0.003 per call)

{
  "type": "object",
  "properties": {
    "method": {
      "type": "string",
      "description": "e.g. GET, POST, PATCH"
    }
  },
  "required": [
    "method"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}