Download the PHP package flat/api without Composer
On this page you can find all versions of the php package flat/api. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package api
Short Description PHP client for the Flat REST API
License Apache-2.0
Homepage https://github.com/FlatIO/api-client-php
Informations about the package api
PHP Client for the Flat REST API
The Flat API allows you to easily extend the abilities of the Flat Platform, with a wide range of use cases including the following:
- Creating and importing new music scores using MusicXML or MIDI files
- Browsing, updating, copying, exporting the user's scores (for example in MP3, WAV or MIDI)
- Managing educational resources with Flat for Education: creating & updating the organization accounts, the classes, rosters and assignments.
You can find the API reference including code samples and our OpenAPI Specification at the following url: https://flat.io/developers/api/reference.
To request some API credentials, please visit https://flat.io/developers.
This Python package is automatically generated by the Swagger Codegen project.
Requirements
PHP 5.6.0 and later
Installation & Usage
Composer
To install the bindings via Composer, add the following to composer.json
:
Then run composer install
Manual Installation
Download the files and include autoload.php
:
Tests
To run the unit tests:
Getting Started
Please follow the installation procedure and then run the following:
Documentation for API Endpoints
All URIs are relative to https://api.flat.io/v2
Class | Method | HTTP request | Description |
---|---|---|---|
AccountApi | getAuthenticatedUser | GET /me | Get current user profile |
ClassApi | activateClass | POST /classes/{class}/activate | Activate the class |
ClassApi | addClassUser | PUT /classes/{class}/users/{user} | Add a user to the class |
ClassApi | archiveClass | POST /classes/{class}/archive | Archive the class |
ClassApi | copyAssignment | POST /classes/{class}/assignments/{assignment}/copy | Copy an assignment |
ClassApi | createAssignment | POST /classes/{class}/assignments | Assignment creation |
ClassApi | createClass | POST /classes | Create a new class |
ClassApi | createSubmission | PUT /classes/{class}/assignments/{assignment}/submissions | Create or edit a submission |
ClassApi | deleteClassUser | DELETE /classes/{class}/users/{user} | Remove a user from the class |
ClassApi | editSubmission | PUT /classes/{class}/assignments/{assignment}/submissions/{submission} | Edit a submission |
ClassApi | enrollClass | POST /classes/enroll/{enrollmentCode} | Join a class |
ClassApi | getClass | GET /classes/{class} | Get the details of a single class |
ClassApi | getScoreSubmissions | GET /scores/{score}/submissions | List submissions related to the score |
ClassApi | getSubmission | GET /classes/{class}/assignments/{assignment}/submissions/{submission} | Get a student submission |
ClassApi | getSubmissions | GET /classes/{class}/assignments/{assignment}/submissions | List the students' submissions |
ClassApi | listAssignments | GET /classes/{class}/assignments | Assignments listing |
ClassApi | listClassStudentSubmissions | GET /classes/{class}/students/{user}/submissions | List the submissions for a student |
ClassApi | listClasses | GET /classes | List the classes available for the current user |
ClassApi | unarchiveClass | DELETE /classes/{class}/archive | Unarchive the class |
ClassApi | updateClass | PUT /classes/{class} | Update the class |
CollectionApi | addScoreToCollection | PUT /collections/{collection}/scores/{score} | Add a score to the collection |
CollectionApi | createCollection | POST /collections | Create a new collection |
CollectionApi | deleteCollection | DELETE /collections/{collection} | Delete the collection |
CollectionApi | deleteScoreFromCollection | DELETE /collections/{collection}/scores/{score} | Delete a score from the collection |
CollectionApi | editCollection | PUT /collections/{collection} | Update a collection's metadata |
CollectionApi | getCollection | GET /collections/{collection} | Get collection details |
CollectionApi | listCollectionScores | GET /collections/{collection}/scores | List the scores contained in a collection |
CollectionApi | listCollections | GET /collections | List the collections |
CollectionApi | untrashCollection | POST /collections/{collection}/untrash | Untrash a collection |
GroupApi | getGroupDetails | GET /groups/{group} | Get group information |
GroupApi | getGroupScores | GET /groups/{group}/scores | List group's scores |
GroupApi | listGroupUsers | GET /groups/{group}/users | List group's users |
OrganizationApi | createLtiCredentials | POST /organizations/lti/credentials | Create a new couple of LTI 1.x credentials |
OrganizationApi | createOrganizationInvitation | POST /organizations/invitations | Create a new invitation to join the organization |
OrganizationApi | createOrganizationUser | POST /organizations/users | Create a new user account |
OrganizationApi | listLtiCredentials | GET /organizations/lti/credentials | List LTI 1.x credentials |
OrganizationApi | listOrganizationInvitations | GET /organizations/invitations | List the organization invitations |
OrganizationApi | listOrganizationUsers | GET /organizations/users | List the organization users |
OrganizationApi | removeOrganizationInvitation | DELETE /organizations/invitations/{invitation} | Remove an organization invitation |
OrganizationApi | removeOrganizationUser | DELETE /organizations/users/{user} | Remove an account from Flat |
OrganizationApi | revokeLtiCredentials | DELETE /organizations/lti/credentials/{credentials} | Revoke LTI 1.x credentials |
OrganizationApi | updateOrganizationUser | PUT /organizations/users/{user} | Update account information |
ScoreApi | addScoreCollaborator | POST /scores/{score}/collaborators | Add a new collaborator |
ScoreApi | addScoreTrack | POST /scores/{score}/tracks | Add a new video or audio track to the score |
ScoreApi | createScore | POST /scores | Create a new score |
ScoreApi | createScoreRevision | POST /scores/{score}/revisions | Create a new revision |
ScoreApi | deleteScore | DELETE /scores/{score} | Delete a score |
ScoreApi | deleteScoreComment | DELETE /scores/{score}/comments/{comment} | Delete a comment |
ScoreApi | deleteScoreTrack | DELETE /scores/{score}/tracks/{track} | Remove an audio or video track linked to the score |
ScoreApi | editScore | PUT /scores/{score} | Edit a score's metadata |
ScoreApi | forkScore | POST /scores/{score}/fork | Fork a score |
ScoreApi | gerUserLikes | GET /users/{user}/likes | List liked scores |
ScoreApi | getGroupScores | GET /groups/{group}/scores | List group's scores |
ScoreApi | getScore | GET /scores/{score} | Get a score's metadata |
ScoreApi | getScoreCollaborator | GET /scores/{score}/collaborators/{collaborator} | Get a collaborator |
ScoreApi | getScoreCollaborators | GET /scores/{score}/collaborators | List the collaborators |
ScoreApi | getScoreComments | GET /scores/{score}/comments | List comments |
ScoreApi | getScoreRevision | GET /scores/{score}/revisions/{revision} | Get a score revision |
ScoreApi | getScoreRevisionData | GET /scores/{score}/revisions/{revision}/{format} | Get a score revision data |
ScoreApi | getScoreRevisions | GET /scores/{score}/revisions | List the revisions |
ScoreApi | getScoreSubmissions | GET /scores/{score}/submissions | List submissions related to the score |
ScoreApi | getScoreTrack | GET /scores/{score}/tracks/{track} | Retrieve the details of an audio or video track linked to a score |
ScoreApi | getUserScores | GET /users/{user}/scores | List user's scores |
ScoreApi | listScoreTracks | GET /scores/{score}/tracks | List the audio or video tracks linked to a score |
ScoreApi | markScoreCommentResolved | PUT /scores/{score}/comments/{comment}/resolved | Mark the comment as resolved |
ScoreApi | markScoreCommentUnresolved | DELETE /scores/{score}/comments/{comment}/resolved | Mark the comment as unresolved |
ScoreApi | postScoreComment | POST /scores/{score}/comments | Post a new comment |
ScoreApi | removeScoreCollaborator | DELETE /scores/{score}/collaborators/{collaborator} | Delete a collaborator |
ScoreApi | untrashScore | POST /scores/{score}/untrash | Untrash a score |
ScoreApi | updateScoreComment | PUT /scores/{score}/comments/{comment} | Update an existing comment |
ScoreApi | updateScoreTrack | PUT /scores/{score}/tracks/{track} | Update an audio or video track linked to a score |
UserApi | gerUserLikes | GET /users/{user}/likes | List liked scores |
UserApi | getUser | GET /users/{user} | Get a public user profile |
UserApi | getUserScores | GET /users/{user}/scores | List user's scores |
Documentation For Models
- Assignment
- AssignmentCopy
- AssignmentCreation
- AssignmentSubmission
- AssignmentSubmissionUpdate
- ClassAttachmentCreation
- ClassCreation
- ClassDetails
- ClassDetailsCanvas
- ClassDetailsClever
- ClassDetailsGoogleClassroom
- ClassDetailsGoogleDrive
- ClassDetailsLti
- ClassRoles
- ClassState
- ClassUpdate
- Collection
- CollectionCapabilities
- CollectionCreation
- CollectionModification
- CollectionPrivacy
- CollectionTitle
- CollectionType
- FlatErrorResponse
- FlatLocales
- GoogleClassroomCoursework
- GoogleClassroomSubmission
- Group
- GroupDetails
- GroupType
- LicenseMode
- LicenseSources
- LmsName
- LtiCredentials
- LtiCredentialsCreation
- MediaAttachment
- MediaScoreSharingMode
- OrganizationInvitation
- OrganizationInvitationCreation
- OrganizationRoles
- ResourceCollaboratorCreation
- ResourceRights
- ResourceSharingKey
- ScoreComment
- ScoreCommentContext
- ScoreCommentCreation
- ScoreCommentUpdate
- ScoreCommentsCounts
- ScoreCreation
- ScoreCreationType
- ScoreData
- ScoreDataEncoding
- ScoreFork
- ScoreLicense
- ScoreLikesCounts
- ScoreModification
- ScorePrivacy
- ScoreRevision
- ScoreRevisionCreation
- ScoreRevisionStatistics
- ScoreSource
- ScoreSummary
- ScoreTrack
- ScoreTrackCreation
- ScoreTrackPoint
- ScoreTrackState
- ScoreTrackType
- ScoreTrackUpdate
- ScoreViewsCounts
- UserAdminUpdate
- UserBasics
- UserCreation
- UserDetailsAdminLicense
- UserInstruments
- ResourceCollaborator
- ScoreDetails
- UserPublicSummary
- UserDetailsAdmin
- UserPublic
- UserDetails
Documentation For Authorization
OAuth2
- Type: OAuth
- Flow: accessCode
- Authorization URL: https://flat.io/auth/oauth
- Scopes:
- account.public_profile: Provides access to the basic person's public profile. Education profiles may be anonymized with this scope, you can request the scope
education_profile
to access to the a basic education account profile. - account.education_profile: Provides access to the basic person's education profile and public organization information.
- scores.readonly: Allows read-only access to all a user's scores. You won't need this scope to read public scores.
- scores.social: Allow to post comments and like scores
- scores: Full, permissive scope to access all of a user's scores.
- collections.readonly: Allow read-only access to a user's collections.
- collections.add_scores: Allow to add scores to a user's collections.
- collections: Full, permissive scope to access all of a user's collections.
- edu.classes: Full, permissive scope to manage the classes.
- edu.classes.readonly: Read-only access to the classes.
- edu.assignments: Read-write access to the assignments and submissions.
- edu.assignments.readonly: Read-only access to the assignments and submissions.
- edu.admin: Full, permissive scope to manage all the admin of an organization.
- edu.admin.lti: Access and manage the LTI Credentials for an organization.
- edu.admin.lti.readonly: Read-only access to the LTI Credentials of an organization.
- edu.admin.users: Access and manage the users and invitations of the organization.
- edu.admin.users.readonly: Read-only access to the users and invitations of the organization.
- account.public_profile: Provides access to the basic person's public profile. Education profiles may be anonymized with this scope, you can request the scope
Author
All versions of api with dependencies
ext-curl Version *
ext-json Version *
ext-mbstring Version *
guzzlehttp/guzzle Version ^6.2