Text Only Import

This API resource enables you to receive your messages from Spot.IM based on etag revisions.

All you need to get started is your spot_id, post_id and a token.

Endpoint

GET https://open-api.spot.im/v1/spot-conversation-events/text-only

Parameters

ParameterValueDescription
token03160313r2lURD (required)Get the access token from your account manager.
spot_idsp_cNLt89un (required)Your Spot ID.
post_id1 (required)Post ID of the page you want to retrieve replies from.
etag0Revision number of events accord in the conversation.
count20Number of events being retrieved from last etag forward.

Example URL

Click this link to see a typical response from the API resource:

https://open-api.spot.im/v1/spot-conversation-events/text-only?token=03160313r2lURD&spot_id=sp_cNLt89un&post_id=1&etag=0&count=2

Response

This is the response you will get from the example url above.

{  
   "conversation_id":"sp_cNLt89un_1",
   "from_etag":0,
   "new_etag":2,
   "events":[  
      {  
         "type":"comment-created",
         "message":{  
            "id":"sp_cNLt89un_1_c_hB6IVi",
            "content":"First Commenter!!! :)",
            "written_at":"2016-03-30 13:23:05 +0000",
            "user_id":"u_EFzKfmsa"
         }
      },
      {  
         "type":"reply-created",
         "message":{  
            "id":"sp_cNLt89un_1_c_hB6IVi_r_xPh7lN",
            "content":"Second as well!",
            "written_at":"2016-03-30 13:23:20 +0000",
            "user_id":"u_EFzKfmsa",
            "comment_id":"sp_cNLt89un_1_c_hB6IVi"
         }
      }
   ],
   "users":{  
      "u_EFzKfmsa":{  
         "user_name":"IdanMitro",
         "display_name":"Idan Mitrofanov",
         "email":"idanm@spot.im"
      }
   },
   "spot_id":"sp_cNLt89un",
   "post_id":"1"
}

Event Types

All the events this API resource provides and their description.

EventDescription
comment-createdComment was created.
comment-editedComment was edited.
comment-deletedComment was deleted along with its replies.
comment-soft-deletedComment was deleted without it's replies.
comment-anonymousComment was anonymized.
reply-createdReply was created.
reply-editedReply was edited.
reply-deletedReply was deleted.
reply-anonymousReply was anonymized.