THIS PAGE IS DEV-PROTECTED UNTIL API PUBLISHER 1.0 RELEASE

Latest Release

June 2023: On behalf of the Ed-Fi community, we are pleased to announce the release of API Publisher 1.0. For more details see What's New in API Publisher.

Overview

The Ed-Fi API Publisher is a utility that can be used to move data from one Ed-Fi ODS/API instance to another ODS/API instance of the same version (i.e ODS/API 6.1 → ODS/API 6.1). It operates as a standard API client against both API endpoints (source and target) and thus it does not require any special network configuration, direct ODS database access or a particular database engine. From a data security/privacy perspective, it is also subject to all authorization performed by the Ed-Fi ODS API endpoints with which it communicates.

The primary user groups for API Publisher are:

...

Primary features of API Publisher includes:

...

If a source API supports the "Change Queries" feature, the Ed-Fi API Publisher will perform a full publishing of the source data on the first run, and then will only publish changed data to the target on subsequent runs. The change versions that have been published to a particular target are maintained in a configuration store automatically for each source/target combination.

Documentation

Documentation for the API Publisher is available online at GitHub via the following links:

Developer Documentation
- README.md - A technical overview of Ed-Fi API Publisher with quick start instructions.
- API-Connection-Management.md - Reference for using Configuration Stores with Ed-Fi API Publisher
  - Aws-Parameter-Store.md - Details for using AWS Parameter Store as the Configuration Store
  - PostgreSql.md - Details for using Postgres as the Configuration Store
  - Sql-Server.md - Details for using SQL Server as the Configuration Store
- API-Publisher-Configuration.md - Reference for API Publisher's configuration with details for each option
- Considerations-for-API-Hosts.md - Considerations for Ed-Fi API hosts for incorporating into production workflows
- Extensibility.md - Developer notes for extensions and modifications.
- Known-Issues-Details.md - Known issues with full details
- Remediations.md - Information on using remediation scripts for failed POSTs
Other Items
- CONTRIBUTORS.md - A listing of contributors to the open-source Ed-Fi API Publisher product.
- LICENSE - The Apache 2.0 license, as applies to the Ed-Fi API Publisher.
- NOTICES.md - A listing of copyright notices for the Ed-Fi API Publisher and libraries in use.

Licensing

The API Publisher tool is licensed through the Apache 2.0 license.