Skip to end of metadata
Go to start of metadata




Overview

API stands for Application Program Interface, and is a set of routines, protocols, and tools for building software applications.

We released our APIs to the public so that you can integrate your systems with Vibes' system in near real-time.

Similar to the ability of the Vibes Mobile Engagement Platform to control Mobile Database and Campaign Manager, its APIs let a customer or partner integrate their software with Mobile Database and Campaign Manager. 

You can integrate with Vibes Mobile Database to store your People, Participants, and Subscribers. You can also use APIs to integrate with Vibes Acquisition Manager and Wallet Manager campaigns.

Vibes encourages you to use real-time integration tools whenever possible.

API Call Structure

The call structure of the APIs is as follows:

  • Method: HTTP is the format used to enable communication between clients (like Web browsers) and servers. The most common methods are GET, POST, PUT and DELETE.
    For more information on HTTP, see: HTTP Specification.
  • URL: The Web address. The URL host is the Vibes public API site.
  • Header: A unit of information that contains information about the file. Vibes APIs use a JSON file.
  • Body: Represents the body of the request or response and allows you to declare what the content type is and how it should be handled.

API Versions

There are currently two versions of the APIs available. You can see what version you are using by looking at the API header.

X-API-Version: 1

Topics in this Section

API Version 1

This is the default version. It does not accept the international format, E.164 phone numbers.

Note: If you are using Version 1, you cannot use the E.164 format. If you do use it, you will get an error returned.

API Version 2

To fully serve its international customers, Vibes released Version 2 of the Vibes Mobile Engagement Platform APIs in 2016 to include support for international E.164 phone numbers.

Example API Version 1

POST
http://public-api.vibescm.com/companies/ABC123/campaigns/acquisition/abc123/participants/
Headers
Content-Type:
Application/JSON
Authorization:
Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
BODY
{
   "external_person_id":"EXT542342",
   "mobile_phone":{
      "mdn":"2995551234"
   },
   "custom_fields":{
      "first_name":"John",
      "last_name":"Doe"
   }
}

Example API Version 2 (E.164 MDN Format)

POST
http://public-api.vibescm.com/companies/ABC123/campaigns/acquisition/abc123/participants/
Headers
Content-Type:
Application/JSON
Authorization:
Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
BODY
{
   "external_person_id":"EXT542342",
   "mobile_phone":{
      "mdn":"+12995551234"
   },
   "custom_fields":{
      "first_name":"John",
      "last_name":"Doe"
   }
}

REST API Tree URI Structure


/companies
/companies/:id 
/companies/:company_id/mobiledb
/companies/:company_id/mobiledb/persons
/companies/:company_id/mobiledb/persons/:person_id
/companies/:company_id/mobiledb/persons/:person_id/subscriptions
/companies/:company_id/mobiledb/persons/:person_id/subscriptions/:subscription_list_id
/companies/:company_id/mobiledb/persons/external/:external_person_id/push_devices
/companies/:company_id/mobiledb/subscription_lists
/companies/:company_id/mobiledb/subscription_lists/:id
/companies/:company_id/mobiledb/subscription_lists/:subscription_list_id
/companies/:company_id/mobiledb/subscription_lists/:subscription_list_id/subscribers
/companies/:company_id/mobiledb/subscription_lists/:subscription_list_id/acquisition_campaigns
/companies/:company_id/mobiledb/broadcasts
/companies/:company_id/mobiledb/broadcasts/:broadcast_id
/companies/:company_id/campaigns
/companies/:company_id/campaigns/acquisition
/companies/:company_id/campaigns/acquisition/:campaign_key
/companies/:company_id/campaigns/acquisition/:campaign_key/participants 
/companies/:company_id/campaigns/acquisition/:id
/companies/:company_id/campaigns/acquisition/:id/participants
/companies/:company_id/campaigns/wallet
/companies/:company_id/campaigns/wallet/:id
/companies/:company_id/campaigns/wallet/:id/items
/companies/:company_id/campaigns/wallet/:id/items/:item_id 
/companies/:company_id/campaigns/wallet/:id/messages
/companies/:company_id/campaigns/wallet/:id/messages/:message_id
/companies/:company_id/incentives
/companies/:company_id/incentives/pools
/companies/:company_id/incentives/pools/:pool_id
/companies/:company_id/incentives/pools/:pool_id/issuances
/companies/:company_id/incentives/codes
/companies/:company_id/incentives/codes/:code
/companies/:company_id/incentives/codes/:code/issuances
/companies/:company_id/incentives/codes/:code/redemptions
/companies/:company_id/events
/companies/:company_id/events/types
/companies/:company_id/config
/companies/:company_id/config/callbacks
/companies/:company_id/config/callbacks/:id
/companies/:company_id/config/callbacks/:callback_id
/companies/:company_id/config/callback_events/test
/mobile_apps/:app_id/devices/:vibes_device_id
/mobile_apps/:app_id/devices/:vibes_device_id/assign

 

 

  • No labels

1 Comment

  1. Former full copy:

    • /companies [ G ]
      • /companies/:id [ G ]
        • /companies/:id/heartbeat [ G ]
        • /companies/:id/mobiledb
          • /companies/:id/mobiledb/persons [ S,P ]
            • /companies/:company_id/mobiledb/persons/:person_id  [ G,U ]
              • /companies/:company_id/mobiledb/persons/:person_id/tags [ G,P,D ]
                • /companies/:company_id/mobiledb/persons/:person_id/tags/:tag [ G,U,D ]
              • /companies/:company_id/mobiledb/persons/:person_id/subscriptions [ G ]
                • /companies/:company_id/mobiledb/persons/:person_id/subscriptions/:subscription_list_id  [ G, D, U? ]
              • /companies/:company_id/mobiledb/persons/:person_id/pending_acquistions [ G ]
          • /companies/:id/mobiledb/subscription_lists [ G ]
            • /companies/:id/mobiledb/subscription_lists/:id [ G ] 
              • /companies/:id/mobiledb/subscription_lists/:id/acquisition_campaigns [ G ]
              • /companies/:id/mobiledb/subscription_lists/:id/subscribers [ S ]
          • /companies/:id/mobiledb/broadcasts [ S,P  ]
            • /companies/:id/mobiledb/broadcasts/:broadcast_id [ G,U,D? ]
          • /companies/:id/mobiledb/custom_fields [ G ]
            • /companies/:id/mobiledb/custom_fields/:id [ G ]
        • /companies/:id/campaigns
          • /companies/:id/campaigns/acquisition [ G ] 
            • /companies/:id/campaigns/acquisition/:id [ G ] 
              • /companies/:id/campaigns/acquisition/:id/participants [ S,P ]
          • /companies/:id/campaigns/wallet [ G ] 
            • /companies/:id/campaigns/wallet/:id [ G ] 
              • /companies/:id/campaigns/wallet/:id/items [ G ] 
                • /companies/:id/campaigns/wallet/:id/items/:item_id [ GU ] 
              • /companies/:id/campaigns/wallet/:id/messages [ S,P ] 
                • /companies/:id/campaigns/wallet/:id/messages/:message_id [ G ] 
        • /companies/:id/config
          • /companies/:id/config/callbacks [ G,S,P ]
            • /companies/:id/config/callbacks/:callback_id [ G,D ]
    • /heartbeat [ G ]