Skip to content

Commit cc3d0c5

Browse files
Updated language
1 parent f20ee44 commit cc3d0c5

3 files changed

Lines changed: 5 additions & 6 deletions

File tree

general-information.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -148,12 +148,11 @@ During the Beta period for this feature, location and telemtry data remain requi
148148

149149
[Top][toc]
150150

151-
## Open Data APIs
151+
## Optional Authentication
152152

153-
Policy and Geography APIs are intended to be Open Data. This allows transparency for the public to see how the city is regulating, holds the city accountable for their policy decisions, and reduces the technical burden on providers to use these endpoints. Additionally, benefit is that this allows third parties to ingest this information into their applications and services for public benefit.
153+
Authorization of the Policy and Geography APIs is no longer required and will be deprecated in next major release with these endpoints becoming optionally private instead of optionally public. An agency may optionally decide to make both the Policy and Geography endpoints unauthenticated and public. This allows transparency for the public to see how the city is regulating, holds the city accountable for their policy decisions, and reduces the technical burden on providers to use these endpoints. A side benefit is that this allows third parties to ingest this information into their applications and services for public benefit.
154154

155-
156-
To preserve backward compatibility, hosting these endpoints with authentication is not explicitly disallowed by MDS. However, beginning with MDS 1.1, it is recommended that these endpoints be unauthenticated and public. Additionally, it is required that these endpoints be public when implementing Geography Driven Events.
155+
Note if implementing the beta features [Geography Driven Events](/general-information.md#geography-driven-events), both Policy and Geography must be public.
157156

158157
[Top][toc]
159158

geography/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ See the [Responses][responses] and [Error Messages][error-messages] sections.
8181

8282
### Authorization
8383

84-
Authorization of the Geography API is not required or recommended. See [Open Data APIs](/general-information.md#open-data-apis) for details.
84+
Authorization is not required. An agency may decide to make this endpoint unauthenticated and public. See [Optional Authentication](/general-information.md#optional-authentication) for details.
8585

8686
[Top][toc]
8787

policy/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,8 +91,8 @@ The response to a client request must include a valid HTTP status code defined i
9191
See the [Responses section][responses] for information on valid MDS response codes and the [Error Messages section][error-messages] for information on formatting error messages.
9292

9393
### Authorization
94-
Authorization of the Policy API endpoints is not required or recommended. See [Open Data APIs](/general-information.md#open-data-apis) for details.
9594

95+
Authorization is not required. An agency may decide to make this endpoint unauthenticated and public. See [Optional Authentication](/general-information.md#optional-authentication) for details.
9696

9797
#### Policies
9898

0 commit comments

Comments
 (0)