Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Status codes provide extra information when a request is made to the MTAPI. The response code will be provided when a request has been successfully completed.

...

Response Headers
{
"cache-control": "no-cache",
"content-length": "123",
"content-type": "application/json; charset=utf-8",
"date": "Tue, 20 Apr 2021 11:28:03 GMT",
"expires": "-1",
"mtapistatus": "-1",
"pragma": "no-cache",
"server": "Microsoft-IIS/8.5",
"x-aspnet-version": "4.0.30319",
"x-powered-by": "ASP.NET"
}

...

  • ServiceRequestNotFound = 4041001
    4041001 is a generic MTAPI status used in more than one controller. 4041001 is returned when an end-point expects a valid Service Request identifier, however the passed identifier cannot find any Service Request.

  • FileAttachmentNotFound = 4041002
    4041002 is a generic MTAPI status used in more than one controller. 4041002 is returned when an end-point expects a valid file attachment identifier, however the passed identifier cannot find any matching file attachment.

  • ServiceRequestNotFound = 4041001, // not found errors starts with 404 followed by 4 digit code 1001, leaving an opportunity use sub status codes below 1000

  • UserNotFound = 4041003, // not found errors starts with 404 followed by 4 digit code

  • ServiceNotFound = 4041004, // not found errors starts with 404 followed by 4 digit code

  • ServiceSettingNotFound = 4041005

  • ServicePreferenceNotFound = 4041006

  • ClientServiceNotFound = 4041007

  • OrganizationNoFound = 4041008

  • ArtifactNoFound = 4041009

  • ServiceRequestIdNotFound = 4041010

  • DocumentNotFound = 4041011

Generic/Reusable Statuses - can be used in any controller (901000-902999)

...

Artifacts Controller (604000-604999)

  • ARTIFACT_NOT_FOUND = 4000InvalidArtifactType = 604001

Invalid Artifact Type

  • UpdatingArtifactFailed = 604002

Updating Artifact Failed

  • DeletingArtifactFailed = 604003

Deleting Artifact Failed

  • RetrievingArtifactFailed = 604004

Retrieving Artifact Failed

  • CreatingArtifactFailed = 604004

Creating Artifact Failed

  • VerifyingArtifactFailed = 604005

Verifying Artifact Failed

  • RetrievingDeletedArtifactFailed = 604006

Trying to retrieve deleted artifact failed

Email Notification Controller (605000-605999)

...

  • CannotCreateStructure = 609000

Organization Controller (

...

611000-

...

611999)

  • Retrieving organization failed
    RetrievingOrganizationFailed = 611001

  • Organization Id is not valid
    InvalidOrganization = 611002

  • Adding organization failed

...

  • Updating organization failed
    UpdatingOrganizationFailed = 611004

  • Invalid argument
    InvalidArgument = 611005

  • Deleting organization failed
    DeletingOrganizationFailed = 611005611006

Notices Controller (612000-612999)

...