Open edX Community Home
Spaces
Teams
Apps
Templates
Create
Architecture and Engineering
All content
Calendars
Space settings
Shortcuts
How-to articles
How-to articles
This trigger is hidden
Retrospectives
Retrospectives
This trigger is hidden
Content
Results will update as you type.
Architecture Design Documents
Architecture Notes and Thoughts
•
Changelogs
Adaptive Learning
API Exploration
Auth Notes
Discussions
Gating: Subsection Gating
LabXchange
Open edX Architecture Course
Services and IDAs
Technical Design Discussions
Notifications Service
LTI Home
Taming the Monolith
Open edX Features
Development Best Practices
•
Analytics and Diagnostics
Django Best Practices
Feature Flags and Settings on edx-platform
Git Best Practices
Naming
Tools and Technology Standards
Open edX REST API Conventions
•
Optional Fields and API Versioning
•
Proposal: API collection format.
•
Proposal: Opt-in Public Url Subset
•
Merging code for safe deployments
•
GitHub Actions Best Practices
•
Health repo dashboard Initial Standards
ThoughtWorks Technology Radar Discussions
•
Content Security Policy
•
Clickjacking
Tests: Discovery, Plan, Notes
Devstack
Video
Developer Documentation
Toggles and Settings
Observability Backlog and Notes
•
Moving from RabbitMQ to Redis
•
Event Storming
Event Bus Project
•
Application Performance Monitoring
•
Tracking logs on edx-platform
•
Extensibility and Customization Mechanism Definitions
•
Makefile Management
•
Pact - Contract Testing
Development Environment
Translations
•
State of edx-search 2023
•
Flaky Test Process
•
Migrating Courses to Learning Core
Architecture Debt & Challenges
Eng process improvements
Public RCA blurbs from edx.org
Arch Meetings
Engineering Studies
How-Tos
Architecture Roadmap
Architecture Vision & Principles
Misc. Public Engineering Documents
Blogs
You‘re viewing this with anonymous access, so some content might be blocked.
Close
Architecture and Engineering
/
Open edX REST API Conventions
Open edX REST API Conventions
Nimisha Asthagiri (Deactivated)
Sarina Canelake
Steve Magoun (Deactivated)
+16
Owned by
Nimisha Asthagiri (Deactivated)
Last updated:
Jul 31, 2023
by
Sarina Canelake
9 min read
Loading data...
1
Background
2
High Level Requirements
3
Conventions
3.1
1. URL Naming
3.2
2. Identifying Resources
3.3
3. HTTP Verbs
3.3.1
A note on HTTP PATCH
3.4
4. URL Parameters
3.5
5. Errors
3.6
6. Version
3.7
7. Pagination
3.8
8. Documentation
3.9
9. Discoverability
3.10
10. Multiple Formats
3.11
11. Authentication