From 20e20674efc8103f67bed3ecf5f664c42ec39f3b Mon Sep 17 00:00:00 2001 From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com> Date: Tue, 15 Oct 2024 00:09:48 +0000 Subject: [PATCH 1/6] feat(openapi): add support for Bridge API key authentication --- openapi.json | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/openapi.json b/openapi.json index ea9ada5..e99e145 100644 --- a/openapi.json +++ b/openapi.json @@ -1662,6 +1662,7 @@ "HMAC", "BASIC_AUTH", "API_KEY", + "BRIDGE", "CLOUDSIGNAL", "COURIER", "FRONTAPP", @@ -2982,6 +2983,40 @@ "additionalProperties": false, "x-docs-type": "API Key" }, + "VerificationBridgeConfigs": { + "type": "object", + "properties": { + "public_key": { + "type": "string" + } + }, + "required": [ + "public_key" + ], + "additionalProperties": false, + "description": "The verification configs for Bridge. Only included if the ?include=verification.configs query param is present", + "x-docs-type": "BridgeConfigs" + }, + "VerificationBridge": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "bridge", + "BRIDGE" + ] + }, + "configs": { + "$ref": "#/components/schemas/VerificationBridgeConfigs" + } + }, + "required": [ + "type" + ], + "additionalProperties": false, + "x-docs-type": "Bridge" + }, "VerificationCloudSignalConfigs": { "type": "object", "properties": { @@ -4986,6 +5021,9 @@ { "$ref": "#/components/schemas/VerificationAPIKey" }, + { + "$ref": "#/components/schemas/VerificationBridge" + }, { "$ref": "#/components/schemas/VerificationCloudSignal" }, From 1e47be7d06aac7c73591a81b91cd36de18b635b5 Mon Sep 17 00:00:00 2001 From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com> Date: Wed, 16 Oct 2024 00:09:23 +0000 Subject: [PATCH 2/6] feat(openapi.json): added support for Treezor payment gateway --- openapi.json | 40 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 39 insertions(+), 1 deletion(-) diff --git a/openapi.json b/openapi.json index e99e145..10351d3 100644 --- a/openapi.json +++ b/openapi.json @@ -1720,7 +1720,8 @@ "RAZORPAY", "MAILCHIMP", "PADDLE", - "PAYPAL" + "PAYPAL", + "TREEZOR" ] }, "IntegrationFeature": { @@ -5010,6 +5011,40 @@ "additionalProperties": false, "x-docs-type": "Paypal" }, + "VerificationTreezorConfigs": { + "type": "object", + "properties": { + "webhook_secret_key": { + "type": "string" + } + }, + "required": [ + "webhook_secret_key" + ], + "additionalProperties": false, + "description": "The verification configs for Treezor. Only included if the ?include=verification.configs query param is present", + "x-docs-type": "TreezorConfigs" + }, + "VerificationTreezor": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "treezor", + "TREEZOR" + ] + }, + "configs": { + "$ref": "#/components/schemas/VerificationTreezorConfigs" + } + }, + "required": [ + "type" + ], + "additionalProperties": false, + "x-docs-type": "Treezor" + }, "VerificationConfig": { "oneOf": [ { @@ -5197,6 +5232,9 @@ }, { "$ref": "#/components/schemas/VerificationPaypal" + }, + { + "$ref": "#/components/schemas/VerificationTreezor" } ], "nullable": true, From 8c3af9d66e5bab0b48c55fc93ed669d2bce3f7f8 Mon Sep 17 00:00:00 2001 From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com> Date: Tue, 22 Oct 2024 00:09:42 +0000 Subject: [PATCH 3/6] fix(openapi): Add delete operation for transformations and update retry properties --- openapi.json | 64 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) diff --git a/openapi.json b/openapi.json index 10351d3..e1eb0fe 100644 --- a/openapi.json +++ b/openapi.json @@ -5769,6 +5769,17 @@ "type": "integer", "nullable": true, "description": "Maximum number of retries to attempt" + }, + "response_status_codes": { + "type": "array", + "items": { + "type": "string", + "pattern": "^(?:([2-5]\\d{2})-([2-5]\\d{2})|([><=]{1,2})([2-5]\\d{2})|!?([2-5]\\d{2}))$" + }, + "minItems": 1, + "maxItems": 10, + "nullable": true, + "description": "HTTP codes to retry on. Accepts: range expressions (e.g., \"400-499\", \">400\"), specific codes (e.g., 404), and exclusions (e.g., \"!401\"). Example: [\"500-599\", \">400\", 404, \"!401\"]" } }, "required": [ @@ -16123,6 +16134,59 @@ "x-fern-sdk-group-name": "transformation", "x-fern-sdk-method-name": "retrieve" }, + "delete": { + "operationId": "deleteTransformation", + "summary": "Delete a transformation", + "description": "", + "tags": [ + "Transformations" + ], + "responses": { + "200": { + "description": "An object with deleted transformation id", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "id": { + "type": "string", + "description": "ID of the Transformation" + } + }, + "required": [ + "id" + ], + "additionalProperties": false + } + } + } + }, + "404": { + "description": "Not Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/APIErrorResponse" + } + } + } + } + }, + "parameters": [ + { + "in": "path", + "name": "id", + "schema": { + "type": "string", + "description": "Transformation ID" + }, + "required": true + } + ], + "x-fern-sdk-group-name": "transformation", + "x-fern-sdk-method-name": "delete" + }, "put": { "operationId": "updateTransformation", "summary": "Update a transformation", From 00339b74abec1b01075ac658ed4cb6f572c91990 Mon Sep 17 00:00:00 2001 From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com> Date: Fri, 25 Oct 2024 00:09:55 +0000 Subject: [PATCH 4/6] feat(openapi.json): add support for Praxis payment provider --- openapi.json | 40 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 39 insertions(+), 1 deletion(-) diff --git a/openapi.json b/openapi.json index e1eb0fe..774b22a 100644 --- a/openapi.json +++ b/openapi.json @@ -1721,7 +1721,8 @@ "MAILCHIMP", "PADDLE", "PAYPAL", - "TREEZOR" + "TREEZOR", + "PRAXIS" ] }, "IntegrationFeature": { @@ -5045,6 +5046,40 @@ "additionalProperties": false, "x-docs-type": "Treezor" }, + "VerificationPraxisConfigs": { + "type": "object", + "properties": { + "webhook_secret_key": { + "type": "string" + } + }, + "required": [ + "webhook_secret_key" + ], + "additionalProperties": false, + "description": "The verification configs for Praxis. Only included if the ?include=verification.configs query param is present", + "x-docs-type": "PraxisConfigs" + }, + "VerificationPraxis": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "praxis", + "PRAXIS" + ] + }, + "configs": { + "$ref": "#/components/schemas/VerificationPraxisConfigs" + } + }, + "required": [ + "type" + ], + "additionalProperties": false, + "x-docs-type": "Praxis" + }, "VerificationConfig": { "oneOf": [ { @@ -5235,6 +5270,9 @@ }, { "$ref": "#/components/schemas/VerificationTreezor" + }, + { + "$ref": "#/components/schemas/VerificationPraxis" } ], "nullable": true, From 72d78f50a45599686b0fc8d2701246dd7048c762 Mon Sep 17 00:00:00 2001 From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com> Date: Wed, 30 Oct 2024 00:10:28 +0000 Subject: [PATCH 5/6] docs(openapi): add external URL for webhook verification types --- openapi.json | 135 ++++++++++++++++++++++++++++++++++----------------- 1 file changed, 90 insertions(+), 45 deletions(-) diff --git a/openapi.json b/openapi.json index 774b22a..5a51a55 100644 --- a/openapi.json +++ b/openapi.json @@ -3017,7 +3017,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Bridge" + "x-docs-type": "Bridge", + "x-docs-external-url": "https://apidocs.bridge.xyz/docs/webhook-event-signature-verification" }, "VerificationCloudSignalConfigs": { "type": "object", @@ -3085,7 +3086,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Courier" + "x-docs-type": "Courier", + "x-docs-external-url": "https://www.courier.com/docs/platform/workspaces/outbound-webhooks#step-4-compare-the-signatures" }, "VerificationFrontAppConfigs": { "type": "object", @@ -3119,7 +3121,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "FrontApp" + "x-docs-type": "FrontApp", + "x-docs-external-url": "https://dev.frontapp.com/docs/webhooks-1#verifying-integrity" }, "VerificationTwitterConfigs": { "type": "object", @@ -3153,7 +3156,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Twitter" + "x-docs-type": "Twitter", + "x-docs-external-url": "https://developer.x.com/en/docs/x-api/enterprise/account-activity-api/guides/securing-webhooks" }, "VerificationStripeConfigs": { "type": "object", @@ -3187,7 +3191,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Stripe" + "x-docs-type": "Stripe", + "x-docs-external-url": "https://stripe.com/docs/webhooks#verify-manually" }, "VerificationRechargeConfigs": { "type": "object", @@ -3221,7 +3226,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Recharge" + "x-docs-type": "Recharge", + "x-docs-external-url": "https://docs.getrecharge.com/docs/webhooks-overview#validating-webhooks" }, "VerificationTwilioConfigs": { "type": "object", @@ -3255,7 +3261,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Twilio" + "x-docs-type": "Twilio", + "x-docs-external-url": "https://www.twilio.com/docs/usage/webhooks/webhooks-security#validating-signatures-from-twilio" }, "VerificationGitHubConfigs": { "type": "object", @@ -3289,7 +3296,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "GitHub" + "x-docs-type": "GitHub", + "x-docs-external-url": "https://docs.github.com/en/webhooks/using-webhooks/validating-webhook-deliveries" }, "VerificationShopifyConfigs": { "type": "object", @@ -3323,7 +3331,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Shopify" + "x-docs-type": "Shopify", + "x-docs-external-url": "https://shopify.dev/docs/apps/build/webhooks/subscribe/https#step-2-validate-the-origin-of-your-webhook-to-ensure-its-coming-from-shopify" }, "VerificationPostmarkConfigs": { "type": "object", @@ -3395,7 +3404,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Typeform" + "x-docs-type": "Typeform", + "x-docs-external-url": "https://www.typeform.com/developers/webhooks/secure-your-webhooks/" }, "VerificationXeroConfigs": { "type": "object", @@ -3429,7 +3439,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Xero" + "x-docs-type": "Xero", + "x-docs-external-url": "https://developer.xero.com/documentation/guides/webhooks/configuring-your-server/" }, "VerificationSvixConfigs": { "type": "object", @@ -3497,7 +3508,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Zoom" + "x-docs-type": "Zoom", + "x-docs-external-url": "https://developers.zoom.us/docs/api/rest/webhook-reference/#verify-webhook-events" }, "VerificationAkeneoConfigs": { "type": "object", @@ -3565,7 +3577,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Adyen" + "x-docs-type": "Adyen", + "x-docs-external-url": "https://docs.adyen.com/development-resources/webhooks/verify-hmac-signatures/" }, "VerificationGitLabConfigs": { "type": "object", @@ -3701,7 +3714,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Oura" + "x-docs-type": "Oura", + "x-docs-external-url": "https://cloud.ouraring.com/v2/docs#section/Security" }, "VerificationCommercelayerConfigs": { "type": "object", @@ -3735,7 +3749,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Commercelayer" + "x-docs-type": "Commercelayer", + "x-docs-external-url": "https://docs.commercelayer.io/core/callbacks-security" }, "VerificationHubspotConfigs": { "type": "object", @@ -3769,7 +3784,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Hubspot" + "x-docs-type": "Hubspot", + "x-docs-external-url": "https://developers.hubspot.com/docs/api/webhooks/validating-requests" }, "VerificationMailgunConfigs": { "type": "object", @@ -3803,7 +3819,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Mailgun" + "x-docs-type": "Mailgun", + "x-docs-external-url": "https://documentation.mailgun.com/docs/mailgun/user-manual/tracking-messages/#webhooks" }, "VerificationPersonaConfigs": { "type": "object", @@ -3837,7 +3854,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Persona" + "x-docs-type": "Persona", + "x-docs-external-url": "https://docs.withpersona.com/docs/webhooks-best-practices#checking-signatures" }, "VerificationPipedriveConfigs": { "type": "object", @@ -3943,7 +3961,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "WorkOS" + "x-docs-type": "WorkOS", + "x-docs-external-url": "https://workos.com/docs/events/data-syncing/webhooks/3-process-the-events/b-validate-the-requests-manually" }, "VerificationSyncteraConfigs": { "type": "object", @@ -3977,7 +3996,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Synctera" + "x-docs-type": "Synctera", + "x-docs-external-url": "https://dev.synctera.com/docs/webhooks-guide#integration-steps" }, "VerificationAWSSNSConfigs": { "type": "object", @@ -4072,7 +4092,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Twitch" + "x-docs-type": "Twitch", + "x-docs-external-url": "https://dev.twitch.tv/docs/eventsub/handling-webhook-events/#verifying-the-event-message" }, "VerificationEnodeConfigs": { "type": "object", @@ -4106,7 +4127,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Enode" + "x-docs-type": "Enode", + "x-docs-external-url": "https://developers.enode.com/docs/webhooks" }, "VerificationFavroConfigs": { "type": "object", @@ -4140,7 +4162,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Favro" + "x-docs-type": "Favro", + "x-docs-external-url": "https://favro.com/developer/#webhook-signatures" }, "VerificationLinearConfigs": { "type": "object", @@ -4174,7 +4197,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Linear" + "x-docs-type": "Linear", + "x-docs-external-url": "https://developers.linear.app/docs/graphql/webhooks#securing-webhooks" }, "VerificationShoplineConfigs": { "type": "object", @@ -4208,7 +4232,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Shopline" + "x-docs-type": "Shopline", + "x-docs-external-url": "https://developer.shopline.com/docsv2/ec20/3cv5d7wpfgr6a8z5/wf8em731s7f8c3ut?version=v20240301#signature-verification" }, "VerificationWixConfigs": { "type": "object", @@ -4242,7 +4267,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Wix" + "x-docs-type": "Wix", + "x-docs-external-url": "https://dev.wix.com/docs/build-apps/build-your-app/authentication/verify-wix-requests" }, "VerificationNMIPaymentGatewayConfigs": { "type": "object", @@ -4276,7 +4302,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "NMI Payment Gateway" + "x-docs-type": "NMI Payment Gateway", + "x-docs-external-url": "https://secure.networkmerchants.com/gw/merchants/resources/integration/integration_portal.php#webhooks_setup" }, "VerificationOrbConfigs": { "type": "object", @@ -4310,7 +4337,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Orb" + "x-docs-type": "Orb", + "x-docs-external-url": "https://docs.withorb.com/guides/integrations-and-exports/webhooks#webhooks-verification" }, "VerificationPylonConfigs": { "type": "object", @@ -4344,7 +4372,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Pylon" + "x-docs-type": "Pylon", + "x-docs-external-url": "https://getpylon.com/developers/guides/using-webhooks/#event-signatures" }, "VerificationRepayConfigs": { "type": "object", @@ -4412,7 +4441,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Square" + "x-docs-type": "Square", + "x-docs-external-url": "https://developer.squareup.com/docs/webhooks/step3validate" }, "VerificationSolidGateConfigs": { "type": "object", @@ -4446,7 +4476,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "SolidGate" + "x-docs-type": "SolidGate", + "x-docs-external-url": "https://docs.solidgate.com/payments/integrate/webhooks/#security" }, "VerificationTrelloConfigs": { "type": "object", @@ -4480,7 +4511,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Trello" + "x-docs-type": "Trello", + "x-docs-external-url": "https://developer.atlassian.com/cloud/trello/guides/rest-api/webhooks/#webhook-signatures" }, "VerificationSanityConfigs": { "type": "object", @@ -4514,7 +4546,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Sanity" + "x-docs-type": "Sanity", + "x-docs-external-url": "https://www.sanity.io/docs/webhooks" }, "VerificationEbayConfigs": { "type": "object", @@ -4564,7 +4597,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Ebay" + "x-docs-type": "Ebay", + "x-docs-external-url": "https://developer.ebay.com/api-docs/commerce/notification/resources/destination/methods/createDestination" }, "VerificationTelnyxConfigs": { "type": "object", @@ -4666,7 +4700,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "TokenIO" + "x-docs-type": "TokenIO", + "x-docs-external-url": "https://developer.token.io/token_rest_api_doc/content/e-rest/webhook_signature_validation.htm?TocPath=_____14" }, "VerificationFiservConfigs": { "type": "object", @@ -4734,7 +4769,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Bondsmith" + "x-docs-type": "Bondsmith", + "x-docs-external-url": "https://docs.bond.tech/docs/signatures" }, "VerificationVercelLogDrainsConfigs": { "type": "object", @@ -4772,7 +4808,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Vercel Log Drains" + "x-docs-type": "Vercel Log Drains", + "x-docs-external-url": "https://vercel.com/docs/rest-api#securing-your-log-drains" }, "VerificationVercelConfigs": { "type": "object", @@ -4806,7 +4843,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Vercel" + "x-docs-type": "Vercel", + "x-docs-external-url": "https://vercel.com/docs/observability/webhooks-overview/webhooks-api#securing-webhooks" }, "VerificationTebexConfigs": { "type": "object", @@ -4840,7 +4878,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Tebex" + "x-docs-type": "Tebex", + "x-docs-external-url": "https://docs.tebex.io/developers/webhooks/overview#verifying-webhook-authenticity" }, "VerificationSlackConfigs": { "type": "object", @@ -4874,7 +4913,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Slack" + "x-docs-type": "Slack", + "x-docs-external-url": "https://api.slack.com/authentication/verifying-requests-from-slack#validating-a-request" }, "VerificationRazorpayConfigs": { "type": "object", @@ -4908,7 +4948,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Razorpay" + "x-docs-type": "Razorpay", + "x-docs-external-url": "https://razorpay.com/docs/webhooks/validate-test/#validate-webhooks" }, "VerificationMailchimpConfigs": { "type": "object", @@ -4976,7 +5017,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Paddle" + "x-docs-type": "Paddle", + "x-docs-external-url": "https://developer.paddle.com/webhooks/signature-verification" }, "VerificationPaypalConfigs": { "type": "object", @@ -5010,7 +5052,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Paypal" + "x-docs-type": "Paypal", + "x-docs-external-url": "https://developer.paypal.com/api/rest/webhooks/rest/" }, "VerificationTreezorConfigs": { "type": "object", @@ -5044,7 +5087,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Treezor" + "x-docs-type": "Treezor", + "x-docs-external-url": "https://docs.treezor.com/guide/webhooks/integrity-checks.html" }, "VerificationPraxisConfigs": { "type": "object", @@ -5078,7 +5122,8 @@ "type" ], "additionalProperties": false, - "x-docs-type": "Praxis" + "x-docs-type": "Praxis", + "x-docs-external-url": "https://doc.praxiscashier.com/integration_docs/latest/webhooks/validation" }, "VerificationConfig": { "oneOf": [ From 2da4e37e40810053bb9cd4221801ae7356cc81c5 Mon Sep 17 00:00:00 2001 From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com> Date: Thu, 31 Oct 2024 00:10:22 +0000 Subject: [PATCH 6/6] fix(openapi.json): update x-docs-external-url for TokenIO type --- openapi.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openapi.json b/openapi.json index 5a51a55..45f97df 100644 --- a/openapi.json +++ b/openapi.json @@ -4701,7 +4701,7 @@ ], "additionalProperties": false, "x-docs-type": "TokenIO", - "x-docs-external-url": "https://developer.token.io/token_rest_api_doc/content/e-rest/webhook_signature_validation.htm?TocPath=_____14" + "x-docs-external-url": "https://developer.token.io/token_rest_api_doc/content/e-rest/webhooks.htm?Highlight=webhook#Signature" }, "VerificationFiservConfigs": { "type": "object",