Skip to content

Commit 310e157

Browse files
committed
Try to make the incoming/outgoing language clearer in the intro section
1 parent f0ee486 commit 310e157

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

proposals/002_Webhooks.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919

2020
## Introduction
2121

22-
Modern APIs often consist of two-way API traffic, but only outgoing API calls or incoming callbacks directly related to an outgoing API call are currently supported by OpenAPI. Incoming HTTP reqests ("webhooks") cannot be described in the current version of OpenAPI.
22+
Modern APIs often consist of two-way API traffic, but OpenAPI currently only supports some types of requests. Standard client-to-server API calls are well supported. Server-to-client callbacks are only supported if they are the result of an earlier API call and are documented by nesting under the path of that earlier call. Incoming HTTP reqests ("webhooks") cannot be described in the current version of OpenAPI if they are the result of subscription arranged outside of the scope of the API (e.g. by setting a callback URL in a web interface).
2323

2424
## Motivation
2525

0 commit comments

Comments
 (0)