From 2ebbb5bd8ebec81eaf15dcb0e6dfc870ab67105c Mon Sep 17 00:00:00 2001 From: Jenny Ramseyer Date: Wed, 13 Mar 2024 11:54:45 -0400 Subject: [PATCH] return URL spec Return URL from https://github.com/bgp/autopeer/pull/21 --- draft-ramseyer-grow-peering-api.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/draft-ramseyer-grow-peering-api.md b/draft-ramseyer-grow-peering-api.md index 9b6d88d..661a06d 100644 --- a/draft-ramseyer-grow-peering-api.md +++ b/draft-ramseyer-grow-peering-api.md @@ -8,7 +8,7 @@ number: date: consensus: true v: 3 -# area: RTG +# area: OPS # workgroup: GROW keyword: - BGP @@ -285,7 +285,8 @@ An email address is needed for communication if the API fails or is not implemen For a programmatic specification of the API, please see the public Github here: [https://github.com/bgp/autopeer/blob/main/api/openapi.yaml](https://github.com/bgp/autopeer/blob/main/api/openapi.yaml) -This initial draft fully specifies the Public Peering endpoints. Private Peering and Maintenance are under discussion, and the authors invite collaboration and discussion from interested parties. +This initial draft fully specifies the Public Peering endpoints. +Private Peering and Maintenance are under discussion, and the authors invite collaboration and discussion from interested parties. DATA TYPES {#datatypes} ---------- @@ -304,7 +305,10 @@ Session Array Array of potential BGP sessions, with request UUID. Request UUID is optional for client, and required for server. - Client may provide initial UUID for client-side tracking, but the server UUID will be the final definitive ID. RequestID will not change across the request. + Return URL is optional, and indicates the client's Peering API endpoint. + The client's return URL is used by the server to request additional sessions. + Client may provide initial UUID for client-side tracking, but the server UUID will be the final definitive ID. + RequestID will not change across the request. BGP Session