Elentra API
  • Introduction
  • Developers
    • Getting Started
    • Quickstart Guide
      • Set up Repositories
      • Validate the setup
      • Exploring the API
      • Creating a new Module
      • Setup Routing
      • Introduction to Postman
      • Create a Controller
      • Using Eloquent Models
      • Input Validation
      • API Resource Authorization
  • Elentra API Standards
    • HTTP Methods & Status Codes
    • Routing & Parameters
      • Example Routing Patterns with HTTP Method
        • /courses/{course}/contacts
        • /courses/{course}/contacts?type={contact_type}
        • /courses/{course}/contacts/{contact}
        • /courses/{course}/syllabus
      • Common Mistakes
        • [GET] /admissions/file-review/file/rubric-score/{cycle_id}/{pool_id}/{subpool_id}
        • [DELETE] /notices/1,2,3
        • [GET] /cbe/curriculum/framework/{framework_id}/hierarchy-by-depth
        • [GET] /admissions/file-review/file/rubric-score/delete/{id}
        • [GET] /portfolio/entries/{entry_id}/get-file
        • [POST] /cbe/curriculum/updateframework
  • Automated Testing
    • Getting Started
      • Setting up a testing environment
      • Running Automated Tests
    • Seed Data
      • Folder Structure
      • Creating Seed Data
    • Functional Tests
      • Creating a Functional Test File
      • Testing HTTP Verbs
        • Creating an HTTP Test
        • GET Requests
        • POST / PUT / DELETE Requests
        • GraphQL Requests
      • Asserting API Response
      • Annotations
    • Code Style Linting
Powered by GitBook
On this page
  1. Elentra API Standards
  2. Routing & Parameters
  3. Example Routing Patterns with HTTP Method

/courses/{course}/syllabus

Collection/Resource/Sub-Resource

Returns the sub-resource.

  • Create a sub-resource that is a single entity as opposed to a collection.

  • Use a singular suffix for the resource, for example /resident instead of /residents

  • This should return the ID, if applicable, in the response.

Status 409 Conflict should be returned if the sub-resource already exists.

The client can only POST once to the resource. If the client POST more than once, then they should get an error.

  • Overwrites the sub-resource if it exists.

  • Creates the sub-resource if it does not exist.

  • This should return the ID, if applicable, in the response.

  • Updates a subset of the resource's attributes.

    • Update specific attributes or relationships.

    • Can pass partial data set to update the resource.

Use with care. PATCH's loose requirements will introduce a higher risk, such as having poor data constraints or difficult-to-read URIs.

Consider using PUT instead of PATCH.

  • Deletes the resource.

    • This can be a soft/hard delete or deactivate/archive.

Previous/courses/{course}/contacts/{contact}NextCommon Mistakes

Last updated 2 years ago