Get MMSID Details API

Table of Contents

getMMSIDDetails

Synopsis:

This API returns all the details of an MMS template given its MMS ID. Such details include:

  • The internal name of the MMS template
  • The MMS subject
  • The fallback SMS text, which is used when the MMS is sent as an SMS instead
  • The date the MMS template was created
  • The total number of slides within the MMS template
  • The size of the MMS template in bytes
  • The poster URL an MMS template, which represents the content that could be used as the MMS preview poster. It is only returned in the response if the MMS Template contains either a video and/or image in any of its slides. The poster URL is generated based on the first content type (either image or video) to appear in the slides ordered within the MMS Template. Thus it will not be generated if the MMS Template only contains plain text or any other types of objects such as audio, pass, pdf, ical, and vcard.

The API also returns all the details of each slide within the MMS template, including the content and slide text. For example, if a slide contains either an image, audio, or video, then the API will return the URL and file size of the original file plus all the transcoded files.

Request: XML

<REQUEST>
   <ACTION>getMMSIDDetails</ACTION>
   <API_KEY>apiKey</API_KEY>
   <MMSID>mmsid</MMSID>
</REQUEST>

Request: GET

API_URL?action=getmmsiddetails
&api_key=API Key
&mmsid=mmsid

Request Parameters:

Mandatory: action, api_key, mmsid

Response Parameters:

status, mmsid, name, subject, fallback_sms_text, date_created, total_slides, size, poster_url, slide, errorCode, errorInfo
MMS content: image, audio, video, dynamic_image, custom_content, pass, template_id, passbook, vcard, ical, pdf, file, url, size

Request Example: XML

<REQUEST>
    <ACTION>getMMSIDDetails</ACTION>
    <API_KEY>qTFkykO9JTfahCOqJ0V2Wf5Cg1t8iWlZ</API_KEY>
    <MMSID>63865</MMSID>
</REQUEST>

Request Example: GET

https://secure.skycore.com/API/wxml/1.3/index.php?action=getmmsiddetails
&api_key=qTFkykO9JTfahCOqJ0V2Wf5Cg1t8iWlZ
&mmsid=63865

Response Example: Success

<RESPONSE>
    <STATUS>Success</STATUS>
    <MMSID>63865</MMSID>
    <NAME>joe's special sandwich promotion</NAME>
    <SUBJECT>Free Joe's special sandwich today!</SUBJECT>
    <FALLBACK_SMS_TEXT>Free Joe's special sandwich today! Click here for more info</FALLBACK_SMS_TEXT>
    <DATE_CREATED>2016-12-29T18:17:29+00:00</DATE_CREATED>
    <TOTAL_SLIDES>2</TOTAL_SLIDES>
    <SIZE>159744</SIZE>
    <POSTER_URL>https://mobilecontent-dev-public.s3.amazonaws.com/userdata/ZVCH0wbKxJTx/mms/63865/image/1/Ac1RMss9/special_coupon.jpg</POSTER_URL>
    <SLIDE>
        <IMAGE>
            <FILE>
                <URL>https://mobilecontent-dev-public.s3.amazonaws.com/userdata/ZVCH0wbKxJTx/mms/63865/image/1/Ac1RMss9/special_coupon.jpg</URL>
                <SIZE>61164</SIZE>
                <DIMENSION>600x500</DIMENSION>
            </FILE>
            <FILE>
                <URL>https://mobilecontent-dev-public.s3.amazonaws.com/userdata/ZVCH0wbKxJTx/mms/63865/image/1/Ac1RMss9/special_coupon-c0-p75.jpg</URL>
                <SIZE>41464</SIZE>
                <DIMENSION>450x375</DIMENSION>
            </FILE>
            <FILE>
                <URL>https://mobilecontent-dev-public.s3.amazonaws.com/userdata/ZVCH0wbKxJTx/mms/63865/image/1/Ac1RMss9/special_coupon-c0-p50.jpg</URL>
                <SIZE>20167</SIZE>
                <DIMENSION>300x250</DIMENSION>
            </FILE>
        </IMAGE>
        <TEXT>Here's a free Joe's special sandwich on us! Coupon valid through 2/1/17.</TEXT>
    </SLIDE>
    <SLIDE>
        <VIDEO>
            <FILE>
                <URL>https://mobilecontent-dev-public.s3.amazonaws.com/userdata/ZVCH0wbKxJTx/mms/63865/video/2/3f8CZNHt/thank_you_video.3gp</URL>
                <SIZE>98226</SIZE>
            </FILE>
            <FILE>
                <URL>https://mobilecontent-dev-public.s3.amazonaws.com/userdata/ZVCH0wbKxJTx/mms/63865/video/2/3f8CZNHt/thank_you_video-mpeg4-8.3gp</URL>
                <SIZE>145463</SIZE>
            </FILE>
            <FILE>
                <URL>https://mobilecontent-dev-public.s3.amazonaws.com/userdata/ZVCH0wbKxJTx/mms/63865/video/2/3f8CZNHt/thank_you_video-h264-8-l.mp4</URL>
                <SIZE>139780</SIZE>
            </FILE>
            <FILE>
                <URL>https://mobilecontent-dev-public.s3.amazonaws.com/userdata/ZVCH0wbKxJTx/mms/63865/video/2/3f8CZNHt/thank_you_video-h264-8.mp4</URL>
                <SIZE>172322</SIZE>
            </FILE>
            <FILE>
                <URL>https://mobilecontent-dev-public.s3.amazonaws.com/userdata/ZVCH0wbKxJTx/mms/63865/video/2/3f8CZNHt/thank_you_video-h264-8-h.mp4</URL>
                <SIZE>224222</SIZE>
            </FILE>
            <FILE>
                <URL>https://mobilecontent-dev-public.s3.amazonaws.com/userdata/ZVCH0wbKxJTx/mms/63865/video/2/3f8CZNHt/thank_you_video-h264-8-smartphone.mp4</URL>
                <SIZE>327685</SIZE>
            </FILE>
            <FILE>
                <URL>https://mobilecontent-dev-public.s3.amazonaws.com/userdata/ZVCH0wbKxJTx/mms/63865/video/2/3f8CZNHt/thank_you_video-h264-8-smartphone-h.mp4</URL>
                <SIZE>565204</SIZE>
            </FILE>
        </VIDEO>
    </SLIDE>
</RESPONSE>

Response Example: Failure

<RESPONSE>
    <STATUS>Failure</STATUS>
    <ERRORCODE>E626</ERRORCODE>
    <ERRORINFO>Content unavailable. Encoding in progress, try again later</ERRORINFO>
</RESPONSE>

General Error Codes:

CodeDescription
E100Invalid request. Make a valid request via GET/POST/XML with all the required variables.
E104User Authentication Failed.
E105This account has no API rights.
E106You can call API every X seconds.
E107This account has no rights to use this action.
E108XML Parse error: $error.
E109API not activated.
E112IP was not whitelisted. API call rejected.
E113Set throughput exceeded for this API action. API call rejected.
E114Phone number is blacklisted. API call rejected.
E120Account has reached the API request limit.
E503Internal error.
CodeDescription
E241The content does not exist
E620The ‘mmsid’ is required
E626Content unavailable. Encoding failed
E626Content unavailable. Encoding in progress, try again later
E629Unrecognised content type

Key Term Definitions:

TermDescription
ACTIONThis is the name of the function you want to execute with the API.
API_KEYRandom key that is assigned to an account that can be used for authorization instead of USER/PASS. You can find and regenerate this key on the ‘API Settings’ page.
MMSIDThe ID(integer) of a saved MMS.