Include JSON in API-related Dev Docs

[zdmc23]

Third-party Integrations with the D.T API send JSON in the body of the request, so let's display the JSON as a "JSON" or "JavaScript" tab in the code block (in addition to existing PHP): https://github.com/GitbookIO/plugin-codetabs

Examples where this would be helpful:

Integrations

For example, Integromat (no-code integration service similar to Zapier)

    "url": "{{connection.clientUrl}}/wp-json/dt-posts/v2/contacts/",
    "method": "POST",
    "body": {
        "title": "{{parameters.title}}",
        "contact_phone": [
            {
                "value": "{{parameters.phoneNumber}}"
            }
        ],
        "location_grid": {
            "values": [
                {
                    "value": "{{parameters.location}}"
                }
            ]
        },
        "sources": {
            "values": [
                {
                    "value": "{{parameters.source}}"
                },
                {
                    "value": "{{parameters.sourceCity}}"
                }
            ]
        }
    },
    "response": {
        "output": "{{body}}"
    }
}

However, when reviewing the D.T API Dev Docs, the developer is presented with a PHP version that they then need to map from PHP to JSON in their head. It would just ease the cognitive load if we presented a Node.js or JSON or JavaScript tab that showed the equivalent in JSON format.

$fields = [
  "sources" => [
    "values" => [ 
      [ "value" => "source" ],  //set a value, the value must be predefined in the field options
      [ "value" => "sourceCity", "delete" => true ] //remove existing
    ],
    "force_values" => false // true will set source to the values entries. removing all others
  ]
]

Testing

It would be helpful when performing any API tests via some HTTP client like cURL or Postman.

Google Cloud

Here is an example of how Google does this in their GCP API docs (and I have seen similar from Azure and other API providers):

[corsacca]

@zdmc23 can you give an example of where you this would be used?

[zdmc23]

Hi @corsacca , sure, I have edited the discussion item to include some examples. Thx!

[corsacca]

Thanks @zdmc23 . I think this would be a great upgrade to the doc!