@open-rpc/examples/build/service-descriptions/params-by-name-petstore-openrpc.json

Collection of example OpenRPC service definition files

{
    "openrpc": "1.0.0-rc1",
    "info": {
        "version": "1.0.0",
        "title": "Petstore By Name",
        "license": {
            "name": "MIT"
        }
    },
    "servers": [
        {
            "url": "http://localhost:8080"
        }
    ],
    "methods": [
        {
            "name": "list_pets",
            "summary": "List all pets",
            "paramStructure": "by-name",
            "tags": [
                {
                    "name": "pets"
                }
            ],
            "params": [
                {
                    "name": "limit",
                    "description": "How many items to return at one time (max 100)",
                    "required": false,
                    "schema": {
                        "type": "integer"
                    }
                }
            ],
            "result": {
                "name": "pets",
                "description": "A paged array of pets",
                "schema": {
                    "$ref": "#/components/schemas/Pets"
                }
            },
            "examples": [
                {
                    "name": "listPetExample",
                    "description": "List pet example",
                    "params": [
                        {
                            "name": "limit",
                            "value": 1
                        }
                    ],
                    "result": {
                        "name": "listPetResultExample",
                        "value": [
                            {
                                "id": 7,
                                "name": "fluffy",
                                "tag": "poodle"
                            }
                        ]
                    }
                }
            ]
        },
        {
            "name": "create_pet",
            "summary": "Create a pet",
            "paramStructure": "by-name",
            "tags": [
                {
                    "name": "pets"
                }
            ],
            "params": [],
            "result": {
                "name": "null",
                "description": "Null response",
                "schema": {
                    "type": "null"
                }
            }
        },
        {
            "name": "get_pet",
            "summary": "Info for a specific pet",
            "tags": [
                {
                    "name": "pets"
                }
            ],
            "paramStructure": "by-position",
            "params": [
                {
                    "name": "petId",
                    "required": true,
                    "description": "The id of the pet to retrieve",
                    "schema": {
                        "type": "string"
                    }
                }
            ],
            "result": {
                "name": "pets",
                "description": "Expected response to a valid request",
                "schema": {
                    "$ref": "#/components/schemas/Pets"
                }
            }
        }
    ],
    "components": {
        "schemas": {
            "Pet": {
                "required": [
                    "id",
                    "name"
                ],
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "name": {
                        "type": "string"
                    },
                    "tag": {
                        "type": "string"
                    }
                }
            },
            "Pets": {
                "type": "array",
                "items": {
                    "$ref": "#/components/schemas/Pet"
                }
            }
        }
    }
}