On Sunday January 22nd 2023 between 10:00 and 15:00 UTC/GMT the API database servers will be unavailable due to maintenance. You can see this in your local time zone at Event Time Announcer - OpenStreetMap API Maintenance
We are planning to upgrade the software which runs the main OpenStreetMap database. Unfortunately, we cannot do this without some downtime.
The following services WILL be affected:
www.openstreetmap.org web site WILL NOT allow edits,
- API will NOT allow map editing (using iD, JOSM, etc), and
- replication updates will be paused (minutely updates and changeset replication).
We expect that the database upgrade will not take the full duration, and we will try as far as possible to keep the API available in read-only mode, but the API may be briefly unavailable.
At times you may be unable to login to services which requires openstreetmap.org authentication (e.g. community, forum, and help)
Other OpenStreetMap provided services should not be affected except for login - all of the following are expected to function normally:
- Map viewing on www.openstreetmap.org
- nominatim (search)
- standard tile layer
- mailing lists
- Distribution of planet file and existing diffs
Services not run by the OSMF will not be impacted, except there will be no updates from OSM.
Technical details are at Plan API database PostgreSQL upgrade · Issue #548 · openstreetmap/operations · GitHub
Also services like OSMCha may be impacted where users need to log in first. Recommendation would be to log in to such services well ahead of the downtime.
(NB: my edit fixed the year, it should be 2023 rather than 2022)
maybe we could have an announcement category for things like this?
I suggested to pin this first. Is there at limit to the number of posts that can be pinned at the same time in this instance?
What HTTP-status codes will the API return during the meantime?
This depends on the time, the endpoint and the authentication method. Could be either no response at all, or some 4xx or 5xx, and for read only use cases even 200.
Specifically, what code will the endpoint to authenticate return during the downtime?
I’m gonna (try to) detect this in MapComplete and show a clear message to possible contributors that OSM is down.
Are you using OAuth 1.0a or OAuth 2?
No problem, it’s christmas day after all
It would be great to know before the downtime; but it is no disaster if you don’t get around letting me know.
I think it would be better to check the results of https://api.openstreetmap.org/api/0.6/capabilities - if any of
<status database="online" api="online" gpx="online"/> reports an “offline” status, you can be pretty sure you won’t be able to upload anything, or also log in to the site.
Yes - the capabilities page is the right page to be checking, because you can do this before the user starts editing, and don’t have to identify which API calls will work on different modes.