Skip to content

Add Pointings, Identifications, and Mag Bands API docs and tutorials#38

Draft
matthewjohnpayne wants to merge 5 commits intomainfrom
further-apis
Draft

Add Pointings, Identifications, and Mag Bands API docs and tutorials#38
matthewjohnpayne wants to merge 5 commits intomainfrom
further-apis

Conversation

@matthewjohnpayne
Copy link
Collaborator

@matthewjohnpayne matthewjohnpayne commented Mar 1, 2026

This PR is a WIP:

  • I want to wait for Mpc api #32 to be merged.
  • Once that is done I will add "wrappers" for the new APIs below (Pointings, Identifications & Mag-bands) to the mpc_api package (introduced in Mpc api #32) as part of this WIP PR.

Summary

  • Migrate Pointings API documentation from legacy site to apis/pointings.md
  • Migrate Mag Bands API documentation from legacy site to apis/mag-bands.md (with corrected API details: GET not POST, flat payload structure, actual response fields)
  • Restructured Identifications pages to provide an explicit API documentation page, consistent with all other APIs
  • Add tutorial notebooks for Pointings API, Identifications API, and Mag Bands API
  • Update APIs index page and tutorial index with links to new content
  • Update CLAUDE.md migration notes

Details

Pointings tutorial (mpc_tutorial_api_pointings.ipynb): Demonstrates all four field geometry options (square, circular, tangent-plane offsets, rectangular). Submission code is in markdown-only cells to prevent accidental production POSTs.

Identifications tutorial (mpc_tutorial_api_identifications.ipynb): Covers DES-to-DES, ITF-to-DES, ITF-to-ITF, and NEOCP linkage types. Submission code is in markdown-only cells.

Mag Bands tutorial (mpc_tutorial_api_mag_bands.ipynb): Fully executable read-only API tutorial. Queries single bands, all bands, demonstrates response fields (band, notes, allowed, v_conversion), and includes a helper function.

Test plan

  • All code cells in all three notebooks execute without errors
  • mkdocs build --strict passes with no errors
  • New notebooks appear in mkdocs build output

🤖 Generated using Claude Code

matthewjohnpayne and others added 5 commits February 28, 2026 20:38
Add tutorial notebooks for the Pointings API (demonstrating all four
field geometry options) and Identifications API, along with the
Pointings API documentation page. Both tutorials use markdown-only
submission cells to prevent accidental production submissions.

Co-Authored-By: Claude Opus 4.6 <[email protected]>
- Migrate Mag Bands API docs from legacy site to apis/mag-bands.md
  with corrected API details (GET not POST, flat payload, real
  response fields: allowed, notes, v_conversion)
- Add Mag Bands tutorial notebook with live API examples
- Fix pointings notebook: true -> True (Python boolean)
- Handle None values in mag-band API responses for band/notes fields
- Update APIs index and api_tutorials.md with new links
- Update CLAUDE.md migration notes

Co-Authored-By: Claude Opus 4.6 <[email protected]>
Create apis/identifications.md as the canonical API reference for the
Identifications submission endpoint, consolidating endpoint, JSON
structure, examples, and Python usage into the apis/ section.

Replace all references to identifications/submission-format.md with
links to the new API page (identifications index, acceptance-criteria,
tutorial notebook) and delete the now-redundant submission-format.md.

Co-Authored-By: Claude Opus 4.6 <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant