{ "openapi" : "3.0.3", "info" : { "title" : "Postman Generator Attributes", "version" : "0.0.1-dev", "description" : "Specification contains various ApiBuilder attributes, which are recognized by Postman Collection Generator" }, "components" : { "schemas" : { "IoPostmanGeneratorAttributesV0ModelsObjectReference" : { "description" : "Attribute instructs the generator to add a setup step with the referenced entity creation. This attribute should be attached to the field (that holds an identifier) inside model or to the resource object (that holds operations and a path with an identifier param).", "type" : "object", "required" : [ "related_service_namespace", "resource_type", "operation_method", "operation_path", "identifier_field" ], "properties" : { "related_service_namespace" : { "description" : "ApiBuilder service's namespace, in which a target operation is specified.", "type" : "string" }, "resource_type" : { "description" : "Resource type, that holds a referenced operation.", "type" : "string" }, "operation_method" : { "$ref" : "#/components/schemas/IoApibuilderSpecV0EnumsMethod", "description" : "Referenced operation method." }, "operation_path" : { "description" : "Operation path corresponding with the selected {{operation_method}}.", "type" : "string" }, "identifier_field" : { "description" : "A field name. When the referenced operation is called, identifier_field is used to extract the corresponding field from the response JSON. If the response JSON is an array, then a value is extracted from the first object.", "type" : "string" }, "query_params" : { "description" : "Optionally, the specified query params will be used to execute a referenced operation.", "type" : "object", "additionalProperties" : { "type" : "string" } }, "delete_operation_path" : { "description" : "Optionally, the referenced entity's DELETE operation path can be put here. If specified, the generator will add a cleanup step for the referenced object.", "type" : "string" } } }, "IoPostmanGeneratorAttributesV0ModelsValueSubstitute" : { "description" : "Attribute instructs the generator to substitute a field value (when generating examples) with specified value or variable reference. Attribute should be attached to a field inside model.", "type" : "object", "required" : [ "substitute" ], "properties" : { "substitute" : { "description" : "Value, which will be put into the field marked by this attribute. It may be also a variable reference.", "type" : "string" } } }, "IoPostmanGeneratorAttributesV0ModelsBasicAuth" : { "description" : "Attribute instructs the generator to add Basic Auth info to the whole Postman collection. Attribute should be defined on the root level of the ApiBuilder specification", "type" : "object", "required" : [ "username", "password" ], "properties" : { "username" : { "description" : "Specifies the username to be used in Postman Collection auth definition. It may be also a variable reference.", "type" : "string" }, "password" : { "description" : "Specified the password to be used in Postman Collection auth definition. It may be also a variable reference. Leave this string empty, when only a username is needed.", "type" : "string" } } }, "IoPostmanGeneratorAttributesV0EnumsAttributeName" : { "description" : "A set of attribute names, that are recognized by Postman Generator", "type" : "string", "enum" : [ "postman-basic-auth", "object-reference", "value-substitute" ] }, "IoApibuilderSpecV0EnumsMethod" : { "type" : "string", "enum" : [ "GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "CONNECT", "OPTIONS", "TRACE" ] } } } }