| rfc8908v1.xml | rfc8908.xml | |||
|---|---|---|---|---|
| skipping to change at line 365 ¶ | skipping to change at line 365 ¶ | |||
| a client connected to a captive network | a client connected to a captive network | |||
| will query the API server to retrieve information about | will query the API server to retrieve information about | |||
| its captive state and conditions to escape captivity. In this example, | its captive state and conditions to escape captivity. In this example, | |||
| the client discovered the URI | the client discovered the URI | |||
| "https://example.org/captive-portal/api/X54PD39JV" using one of the | "https://example.org/captive-portal/api/X54PD39JV" using one of the | |||
| mechanisms defined in <xref target="RFC8910" | mechanisms defined in <xref target="RFC8910" | |||
| format="default"/>.</t> | format="default"/>.</t> | |||
| <t>To request the Captive Portal JSON content, a client sends an HTTP | <t>To request the Captive Portal JSON content, a client sends an HTTP | |||
| GET request:</t> | GET request:</t> | |||
| <sourcecode type=""><![CDATA[ | <sourcecode type="http-message"><![CDATA[ | |||
| GET /captive-portal/api/X54PD39JV HTTP/1.1 | GET /captive-portal/api/X54PD39JV HTTP/1.1 | |||
| Host: example.org | Host: example.org | |||
| Accept: application/captive+json | Accept: application/captive+json | |||
| ]]></sourcecode> | ]]></sourcecode> | |||
| <t>The server then responds with the JSON content for that client:</t> | <t>The server then responds with the JSON content for that client:</t> | |||
| <sourcecode type=""><![CDATA[ | <sourcecode type="http-message"><![CDATA[ | |||
| HTTP/1.1 200 OK | HTTP/1.1 200 OK | |||
| Cache-Control: private | Cache-Control: private | |||
| Date: Mon, 02 Mar 2020 05:07:35 GMT | Date: Mon, 02 Mar 2020 05:07:35 GMT | |||
| Content-Type: application/captive+json | Content-Type: application/captive+json | |||
| { | { | |||
| "captive": true, | "captive": true, | |||
| "user-portal-url": "https://example.org/portal.html" | "user-portal-url": "https://example.org/portal.html" | |||
| } | } | |||
| ]]></sourcecode> | ]]></sourcecode> | |||
| <t>Upon receiving this information, the client will use it | <t>Upon receiving this information, the client will use it | |||
| to direct the user to the web portal (as specified by the | to direct the user to the web portal (as specified by the | |||
| user-portal-url value) to enable access to the external network. Once | user-portal-url value) to enable access to the external network. Once | |||
| the user satisfies the requirements for external network access, the | the user satisfies the requirements for external network access, the | |||
| client <bcp14>SHOULD</bcp14> query the API server again to verify that | client <bcp14>SHOULD</bcp14> query the API server again to verify that | |||
| it is no longer captive.</t> | it is no longer captive.</t> | |||
| <t>When the client requests the Captive Portal JSON content after | <t>When the client requests the Captive Portal JSON content after | |||
| gaining external network access, the server responds with updated JSON | gaining external network access, the server responds with updated JSON | |||
| content:</t> | content:</t> | |||
| <sourcecode type=""><![CDATA[ | <sourcecode type="http-message"><![CDATA[ | |||
| HTTP/1.1 200 OK | HTTP/1.1 200 OK | |||
| Cache-Control: private | Cache-Control: private | |||
| Date: Mon, 02 Mar 2020 05:08:13 GMT | Date: Mon, 02 Mar 2020 05:08:13 GMT | |||
| Content-Type: application/captive+json | Content-Type: application/captive+json | |||
| { | { | |||
| "captive": false, | "captive": false, | |||
| "user-portal-url": "https://example.org/portal.html", | "user-portal-url": "https://example.org/portal.html", | |||
| "venue-info-url": "https://flight.example.com/entertainment", | "venue-info-url": "https://flight.example.com/entertainment", | |||
| "seconds-remaining": 326, | "seconds-remaining": 326, | |||
| End of changes. 3 change blocks. | ||||
| 3 lines changed or deleted | 3 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ | ||||