You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: routing/DELEGATED_CONTENT_ROUTING_HTTP.md
+16-25Lines changed: 16 additions & 25 deletions
Original file line number
Diff line number
Diff line change
@@ -71,36 +71,25 @@ Specifications for some transfer protocols are provided in the "Transfer Protoco
71
71
-`404`: must be returned if no matching records are found
72
72
-`422`: request does not conform to schema or semantic constraints
73
73
- Response Body
74
-
75
-
```json
76
-
{
77
-
"Providers": [
78
-
{
79
-
"Protocol": "<protocol_name>",
80
-
"Schema": "<schema>",
81
-
...
82
-
}
83
-
]
84
-
}
85
-
```
86
-
87
-
- Default limit: 100 providers
88
-
- Optional query parameters
89
-
-`transfer` only return providers who support the passed transfer protocols, expressed as a comma-separated list of transfer protocol names such as `transfer=bitswap,filecoin-graphsync-v1`
90
-
-`transport` for provider records with multiaddrs, only return records with multiaddrs explicitly supporting the passed transport protocols, encoded as decimal multicodec codes such as `transport=460,478` (`/quic` and `/tls/ws` respectively)
91
-
- Implements pagination according to the Pagination section
74
+
```json
75
+
{
76
+
"Providers": [
77
+
{
78
+
"Protocol": "<protocol_name>",
79
+
"Schema": "<schema>",
80
+
...
81
+
}
82
+
]
83
+
}
84
+
```
85
+
86
+
- Response limit: 100 providers
92
87
93
88
Each object in the `Providers` list is a *read provider record*.
94
89
95
90
## Pagination
96
91
97
-
APIs that return collections of results should support pagination as follows:
98
-
99
-
- If there are more results, then a `NextPageToken` field should include an opaque string value, otherwise it should be undefined
100
-
- The value of `NextPageToken` can be specified as the value of a `pageToken` query parameter to fetch the next page
101
-
- Character set is restricted to the regular expression `[a-zA-Z0-9-_.~]+`, since this is intended to be used in URLs
102
-
- The client continues this process until `NextPageToken` is undefined or doesn't care to continue
103
-
- A `pageLimit` query parameter specifies the maximum size of a single page
92
+
This API does not support pagination, but optional pagination can be added in a backwards-compatible spec update.
104
93
105
94
### Implementation Notes
106
95
@@ -140,6 +129,7 @@ This section contains a non-exhaustive list of known transfer protocols (by name
0 commit comments