Convert YAML to JSON

Parses input as YAML 1.2 with the core schema, whatever any %YAML directive says, so yes/no/on/off are strings, 0755 is the decimal 755, and dates stay strings; each such value gets a warning because YAML 1.1 parsers read them differently. Duplicate keys are an error. Aliases are expanded, with at most 1,000 expansions and 200,000 output values (billion-laughs protection); recursive aliases are an error. << merge keys are applied unless merge_keys is false. .inf/.nan and complex (collection) keys are errors; non-string scalar keys become strings with a warning. Tags outside the core schema (!!binary, !!timestamp, !Ref, …) follow custom_tags. Errors give line, column and code.

Browser version (runs locally): YAML Format & Validate.

Parameters

Also accepted on every endpoint: format (json | text). Parameters may come from the query string, a JSON object body, an urlencoded or multipart form, or (for input) a text/plain body.

Response 200 application/json

Text output (format=text, text/plain): The JSON text.

Errors

Errors are JSON: {"error": "<message>", "code": "<code>", "param": "<name>"?}.

Behaviour

• Idempotent: the same arguments always return the same result.
• Requires a client ID and secret (authentication). Each call is recorded as one metadata row against your client ID; inputs and outputs are never stored or logged. Responses carry cache-control: no-store.
• CORS: any origin may call this endpoint from a browser, using your credentials.

Examples

Responses below were produced by running each request through this code at build time. Long strings are shortened.

curl -X POST 'https://util.caruana.me/api/convert/yaml-to-json' \
  -H 'content-type: application/json' \
  -d '{"input":"defaults: &defaults\n  retries: 3\n  country: no\nservice:\n  <<: *defaults\n  mode: 0755\n  port: 8080\n"}'

{
  "json": "{\n  \"defaults\": {\n    \"retries\": 3,\n    \"country\": \"no\"\n  },\n  \"service\": {\n    \"retries\": 3,\n    \"country\": \"no\",\n    \"mode\": 755,\n    \"port\": 8080\n  }\n}",
  "value": {
    "defaults": {
      "retries": 3,
      "country": "no"
    },
    "service": {
      "retries": 3,
      "country": "no",
      "mode": 755,
      "port": 8080
    }
  },
  "documentCount": 1,
  "warnings": [
    {
      "message": "no is the string \"no\" in YAML 1.2, but YAML 1.1 parsers read it as a boolean. Quote it to be unambiguous.",
      "line": 3,
      "column": 12,
      "pointer": "/defaults/country"
    },
    {
      "message": "no is the string \"no\" in YAML 1.2, but YAML 1.1 parsers read it as a boolean. Quote it to be unambiguous.",
      "line": 3,
      "column": 12,
      "pointer": "/service/country"
    },
    {
      "message": "0755 is the decimal integer 755 in YAML 1.2, but YAML 1.1 parsers read a leading 0 as octal (493). Write 0o755 for octal, or quote it for a string.",
      "line": 6,
      "column": 9,
      "pointer": "/service/mode"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "yaml_to_json",
    "arguments": {
      "input": "defaults: &defaults\n  retries: 3\n  country: no\nservice:\n  <<: *defaults\n  mode: 0755\n  port: 8080\n"
    }
  }
}

curl -X POST 'https://util.caruana.me/api/convert/yaml-to-json' \
  -H 'content-type: application/json' \
  -d '{"input":"name: a\n---\nname: b\n","documents":"all","indent":"none"}'

{
  "json": "[{\"name\":\"a\"},{\"name\":\"b\"}]",
  "value": [
    {
      "name": "a"
    },
    {
      "name": "b"
    }
  ],
  "documentCount": 2,
  "warnings": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "yaml_to_json",
    "arguments": {
      "input": "name: a\n---\nname: b\n",
      "documents": "all",
      "indent": "none"
    }
  }
}

curl -X POST 'https://util.caruana.me/api/convert/yaml-to-json' \
  -H 'content-type: application/json' \
  -d '{"input":"Bucket: !Ref MyBucket\nArn: !GetAtt [MyBucket, Arn]\n","custom_tags":"wrap"}'

{
  "json": "{\n  \"Bucket\": {\n    \"!Ref\": \"MyBucket\"\n  },\n  \"Arn\": {\n    \"!GetAtt\": [\n      \"MyBucket\",\n      \"Arn\"\n    ]\n  }\n}",
  "value": {
    "Bucket": {
      "!Ref": "MyBucket"
    },
    "Arn": {
      "!GetAtt": [
        "MyBucket",
        "Arn"
      ]
    }
  },
  "documentCount": 1,
  "warnings": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "yaml_to_json",
    "arguments": {
      "input": "Bucket: !Ref MyBucket\nArn: !GetAtt [MyBucket, Arn]\n",
      "custom_tags": "wrap"
    }
  }
}