MBurger Headless CMS
User GuideCMS HeadlessEngagement Platform
  • ๐Ÿ”MBurger Documentation๐Ÿ”
  • ๐Ÿ”‘ API
    • Introduction
      • Getting Started
      • Structure
    • Common Path
      • Basics
      • POST Bodies
      • POST Relations
      • Evaluating Responses
    • API Authentication
    • Project
    • Blocks
      • Get Blocks
      • Get Block
    • Sections
      • Get Sections
      • Get Section
      • Create Section
      • Update Section
      • Delete Section
    • Media
      • Get All Media
      • Upload Media
      • Get Media
      • Delete Media
    • Integrations / Extensions
      • Authentication Provider
        • Registration
        • Login
        • Logout
        • Get Profile
        • Update Profile
        • Delete Profile
        • Change Password
        • Forgot Password
      • Live Messages
        • Get All Live Messages
        • Send Live Message
        • Delete Live Message
      • In-App Subscriptions
        • InApp Subscription
        • Resume InApp Subscription
      • Shopify
        • Create a Shopify private app
        • Enable Shopify in MBurger
        • Collections Editor
      • Stripe
        • Create Customer
        • Get Cards
        • Create Card
        • Make Default
        • Delete Card
        • Subscription
        • Cancel Subscription
        • Resume Subscription
        • Payment
    • Going Deeper
      • Available Data Types (Elements)
  • ๐Ÿ“ฑ Android SDK
    • Introduction
    • Installation
    • Initialization
    • Fetch for blocks
    • Fetch sections from blocks
    • Mapping to custom objects
    • Admin
      • Delete a Section/Media
      • Create a new Section
      • Update an existing Section
    • Auth
      • Register a new user
      • Authenticate a user
      • User profile
      • Edit profile
      • Other features
    • Proguard Rules
    • Plugins
    • Sample Apps
      • MBurger Explorer
      • MBurger Radio
    • MBurger Apps
  • ๐Ÿ iOS SDK
    • Introduction
    • Installation
    • Initialization
    • Fetch the project
    • Fetch blocks
    • Fetch sections
    • Media
    • Encoding & Decoding
    • Serialization & Equality
    • Admin
      • Add/Edit a section
      • Delete a section
      • Upload media
      • Delete a media
    • Auth
      • Register a user
      • Authenticate a user
      • Retrieve user information
      • Update user profile
    • Plugins
    • Sample Apps
      • MBurger Explorer
      • MBurger Radio
    • MBurger Apps
  • ๐Ÿ’ป PHP SDK
    • Installation & Configuration
    • How to use
    • Support & Feedback
    • License
  • โ˜• JavaScript SDK
    • Introduction
    • Installation
    • Configuration
    • Methods Reference
    • Support & Feedback
    • License
  • ๐Ÿ”ทFlutter SDK
    • Installation
    • Initialization
    • Fetch the project
    • Fetch blocks
    • Fetch sections
    • Media
    • Admin
      • Add/Edit a section
      • Delete a section
      • Upload a media
      • Delete a media
    • Auth
      • Register a user
      • Authenticate a user
      • Retrieve user information
      • Update user profile
  • โ“How to?
    • Basic interactions
      • Blocks
        • Get a Single Block
        • Get multiple Blocks
      • Sections
        • Get a single Section
        • Get Multiple Sections
        • Create a Section
        • Update a Section
        • Delete a Section
    • Advanced section retrieval
      • Filter sections
      • Obtain distance from a section
      • Manage locales and the fallback language
      • Get a section by SLUG
      • Obtain only sections with a defined relation
    • Advanced section creation
      • Create a section with a relation
      • Set the value of a checkbox element
      • Create a section with a multiple or dropdown element
      • Create a section with a SLUG
      • Create a section with SEO
      • Send or schedule a push when creating a section
    • Set the visibility of a section
    • Get images with various format
  • ๐Ÿ‘ป Sample App
    • Introduction
    • Create an MBurger project
    • Create Home, News and Gallery blocks
    • Create the project
    • Setup the SDK
    • Query the API for items
    • Map your objects from MBurger objects
    • Implement push notifications
    • Take a bite
Powered by GitBook
On this page
  • Errors
  • Examples

Was this helpful?

  1. API
  2. Common Path

Evaluating Responses

All API responses contain a JSON object, which will always contain a top-level integer property status_code, indicating success (= 0) or failure (!= 0).

In case of errors, are adopted HTTP status codes are adopted and a JSON string property message that explain the error.

Errors

MBurger APIs uses the following HTTP error codes:

Code

Meaning

Description

400

Bad Request

Your request is invalid.

401

Unauthorized

Your API key is wrong or not present.

403

Forbidden

You don't have permission to access this resource.

404

Not Found

The requested resource can not be found.

405

Method Not Allowed

You tried to use an invalid method.

406

Not Acceptable

You requested a format that isn't json.

422

Unprocessable Entity

Your request did not pass the input validation.

429

Too Many Requests

You're requesting too many! Slow down!

500

Internal Server Error

We had a problem with our server. Try again later.

503

Service Unavailable

We're temporarily offline for maintenance. Please try again later.

Examples

On authentication error is returned an HTTP 401 and a JSON like this:

{
  "message": "The project token is not present."
}

On bad request error is returned an HTTP 400 and a JSON like this:

{
  "message": "Given filter(s) `available` are not allowed. Allowed filter(s) are `id, subscription, value, geofence`."
}

On permission error is returned an HTTP 403 and a JSON like this:

{
  "message": "This action is unauthorized."
}

On not found error is returned an HTTP 404 and a JSON like this:

{
  "message": "The requested resource can not be found."
}

On validation error is returned an HTTP 422 and a JSON like this:

{
  "message": "The given data was invalid.",
  "errors": {
    "email": [
      "The email has already been taken."
    ]
  }
}
PreviousPOST RelationsNextAPI Authentication

Last updated 4 years ago

Was this helpful?

๐Ÿ”‘