blob: 5a13bbbcea93b69b8ac0d725c17cbe8f104eba83 [file] [log] [blame]
{"component":{"kind":"component","name":"vertx-http","title":"Vert.x HTTP Client","description":"Send requests to external HTTP servers using Vert.x","deprecated":false,"firstVersion":"3.5.0","label":"http","javaType":"org.apache.camel.component.vertx.http.VertxHttpComponent","supportLevel":"Stable","groupId":"org.apache.camel","artifactId":"camel-vertx-http","version":"3.18.1","scheme":"vertx-http","extendsScheme":"","syntax":"vertx-http:httpUri","async":false,"api":false,"consumerOnly":false,"producerOnly":true,"lenientProperties":true},"headers":{"CamelHttpMethod":{"kind":"header","displayName":"","group":"producer","label":"","required":false,"javaType":"io.vertx.core.http.HttpMethod","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The http method","constantName":"org.apache.camel.component.vertx.http.VertxHttpConstants#HTTP_METHOD"},"CamelHttpResponseCode":{"kind":"header","displayName":"","group":"producer","label":"","required":false,"javaType":"Integer","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The HTTP response code from the external server.","constantName":"org.apache.camel.component.vertx.http.VertxHttpConstants#HTTP_RESPONSE_CODE"},"CamelHttpResponseText":{"kind":"header","displayName":"","group":"producer","label":"","required":false,"javaType":"String","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The HTTP response text from the external server.","constantName":"org.apache.camel.component.vertx.http.VertxHttpConstants#HTTP_RESPONSE_TEXT"},"Content-Type":{"kind":"header","displayName":"","group":"producer","label":"","required":false,"javaType":"String","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The HTTP content type. Is set on both the IN and OUT message to provide a content type, such as text/html.","constantName":"org.apache.camel.component.vertx.http.VertxHttpConstants#CONTENT_TYPE"},"CamelHttpQuery":{"kind":"header","displayName":"","group":"producer","label":"","required":false,"javaType":"String","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"URI parameters. Will override existing URI parameters set directly on the endpoint.","constantName":"org.apache.camel.component.vertx.http.VertxHttpConstants#HTTP_QUERY"},"CamelHttpUri":{"kind":"header","displayName":"","group":"producer","label":"","required":false,"javaType":"String","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"URI to call. Will override the existing URI set directly on the endpoint. This URI is the URI of the http server to call. Its not the same as the Camel endpoint URI, where you can configure endpoint options such as security etc. This header does not support that, its only the URI of the http server.","constantName":"org.apache.camel.component.vertx.http.VertxHttpConstants#HTTP_URI"},"CamelHttpPath":{"kind":"header","displayName":"","group":"producer","label":"","required":false,"javaType":"String","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"Request URI's path, the header will be used to build the request URI with the HTTP_URI.","constantName":"org.apache.camel.component.vertx.http.VertxHttpConstants#HTTP_PATH"},"Content-Encoding":{"kind":"header","displayName":"","group":"producer","label":"","required":false,"javaType":"String","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The HTTP content encoding. Is set to provide a content encoding, such as gzip.","constantName":"org.apache.camel.component.vertx.http.VertxHttpConstants#CONTENT_ENCODING"}},"properties":{"httpUri":{"kind":"path","displayName":"Http Uri","group":"producer","label":"","required":true,"type":"string","javaType":"java.net.URI","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"The HTTP URI to connect to"},"connectTimeout":{"kind":"parameter","displayName":"Connect Timeout","group":"producer","label":"producer","required":false,"type":"integer","javaType":"int","deprecated":false,"autowired":false,"secret":false,"defaultValue":60000,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"The amount of time in milliseconds until a connection is established. A timeout value of zero is interpreted as an infinite timeout."},"cookieStore":{"kind":"parameter","displayName":"Cookie Store","group":"producer","label":"producer","required":false,"type":"object","javaType":"io.vertx.ext.web.client.spi.CookieStore","deprecated":false,"autowired":false,"secret":false,"defaultValue":"InMemoryCookieStore","configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"A custom CookieStore to use when session management is enabled. If this option is not set then an in-memory CookieStore is used"},"headerFilterStrategy":{"kind":"parameter","displayName":"Header Filter Strategy","group":"producer","label":"producer","required":false,"type":"object","javaType":"org.apache.camel.spi.HeaderFilterStrategy","deprecated":false,"autowired":false,"secret":false,"defaultValue":"VertxHttpHeaderFilterStrategy","configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"A custom org.apache.camel.spi.HeaderFilterStrategy to filter header to and from Camel message."},"httpMethod":{"kind":"parameter","displayName":"Http Method","group":"producer","label":"producer","required":false,"type":"object","javaType":"io.vertx.core.http.HttpMethod","deprecated":false,"autowired":false,"secret":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"The HTTP method to use. The HttpMethod header cannot override this option if set"},"okStatusCodeRange":{"kind":"parameter","displayName":"Ok Status Code Range","group":"producer","label":"producer","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"defaultValue":"200-299","configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"The status codes which are considered a success response. The values are inclusive. Multiple ranges can be defined, separated by comma, e.g. 200-204,209,301-304. Each range must be a single number or from-to with the dash included"},"responsePayloadAsByteArray":{"kind":"parameter","displayName":"Response Payload As Byte Array","group":"producer","label":"producer","required":false,"type":"boolean","javaType":"boolean","deprecated":false,"autowired":false,"secret":false,"defaultValue":true,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"Whether the response body should be byte or as io.vertx.core.buffer.Buffer"},"sessionManagement":{"kind":"parameter","displayName":"Session Management","group":"producer","label":"producer","required":false,"type":"boolean","javaType":"boolean","deprecated":false,"autowired":false,"secret":false,"defaultValue":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"Enables session management via WebClientSession. By default the client is configured to use an in-memory CookieStore. The cookieStore option can be used to override this"},"throwExceptionOnFailure":{"kind":"parameter","displayName":"Throw Exception On Failure","group":"producer","label":"producer","required":false,"type":"boolean","javaType":"boolean","deprecated":false,"autowired":false,"secret":false,"defaultValue":true,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"Disable throwing HttpOperationFailedException in case of failed responses from the remote server"},"timeout":{"kind":"parameter","displayName":"Timeout","group":"producer","label":"producer","required":false,"type":"integer","javaType":"long","deprecated":false,"autowired":false,"secret":false,"defaultValue":-1,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"The amount of time in milliseconds after which if the request does not return any data within the timeout period a TimeoutException fails the request. Setting zero or a negative value disables the timeout."},"transferException":{"kind":"parameter","displayName":"Transfer Exception","group":"producer","label":"producer","required":false,"type":"boolean","javaType":"boolean","deprecated":false,"autowired":false,"secret":false,"defaultValue":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"If enabled and an Exchange failed processing on the consumer side, and if the caused Exception was sent back serialized in the response as a application/x-java-serialized-object content type. On the producer side the exception will be deserialized and thrown as is, instead of HttpOperationFailedException. The caused exception is required to be serialized. This is by default turned off. If you enable this then be aware that Camel will deserialize the incoming data from the request to a Java object, which can be a potential security risk."},"useCompression":{"kind":"parameter","displayName":"Use Compression","group":"producer","label":"producer","required":false,"type":"boolean","javaType":"boolean","deprecated":false,"autowired":false,"secret":false,"defaultValue":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"Set whether compression is enabled to handled compressed (E.g gzipped) responses"},"vertxHttpBinding":{"kind":"parameter","displayName":"Vertx Http Binding","group":"producer","label":"producer","required":false,"type":"object","javaType":"org.apache.camel.component.vertx.http.VertxHttpBinding","deprecated":false,"autowired":false,"secret":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"A custom VertxHttpBinding which can control how to bind between Vert.x and Camel."},"webClientOptions":{"kind":"parameter","displayName":"Web Client Options","group":"producer","label":"producer","required":false,"type":"object","javaType":"io.vertx.ext.web.client.WebClientOptions","deprecated":false,"autowired":false,"secret":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"Sets customized options for configuring the Vert.x WebClient"},"lazyStartProducer":{"kind":"parameter","displayName":"Lazy Start Producer","group":"producer (advanced)","label":"producer,advanced","required":false,"type":"boolean","javaType":"boolean","deprecated":false,"autowired":false,"secret":false,"defaultValue":false,"description":"Whether the producer should be started lazy (on the first message). By starting lazy you can use this to allow CamelContext and routes to startup in situations where a producer may otherwise fail during starting and cause the route to fail being started. By deferring this startup to be lazy then the startup failure can be handled during routing messages via Camel's routing error handlers. Beware that when the first message is processed then creating and starting the producer may take a little time and prolong the total processing time of the processing."},"proxyHost":{"kind":"parameter","displayName":"Proxy Host","group":"proxy","label":"proxy","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"The proxy server host address"},"proxyPassword":{"kind":"parameter","displayName":"Proxy Password","group":"proxy","label":"proxy","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"The proxy server password if authentication is required"},"proxyPort":{"kind":"parameter","displayName":"Proxy Port","group":"proxy","label":"proxy","required":false,"type":"integer","javaType":"java.lang.Integer","deprecated":false,"autowired":false,"secret":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"The proxy server port"},"proxyType":{"kind":"parameter","displayName":"Proxy Type","group":"proxy","label":"proxy","required":false,"type":"object","javaType":"io.vertx.core.net.ProxyType","enum":["HTTP","SOCKS4","SOCKS5"],"deprecated":false,"autowired":false,"secret":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"The proxy server type"},"proxyUsername":{"kind":"parameter","displayName":"Proxy Username","group":"proxy","label":"proxy","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"The proxy server username if authentication is required"},"basicAuthPassword":{"kind":"parameter","displayName":"Basic Auth Password","group":"security","label":"security","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"The password to use for basic authentication"},"basicAuthUsername":{"kind":"parameter","displayName":"Basic Auth Username","group":"security","label":"security","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"The user name to use for basic authentication"},"bearerToken":{"kind":"parameter","displayName":"Bearer Token","group":"security","label":"security","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"The bearer token to use for bearer token authentication"},"sslContextParameters":{"kind":"parameter","displayName":"Ssl Context Parameters","group":"security","label":"security","required":false,"type":"object","javaType":"org.apache.camel.support.jsse.SSLContextParameters","deprecated":false,"autowired":false,"secret":false,"configurationClass":"org.apache.camel.component.vertx.http.VertxHttpConfiguration","configurationField":"configuration","description":"To configure security using SSLContextParameters"}}}