POST selfie/hashtags/create bulk

From Social ID Developers
(Difference between revisions)
Jump to: navigation, search
 
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
#REDIRECT [[POST selfie/hashtags/create bulk PT-BR]]
+
<span style="color: red; font-weight: bold">Deprecation notice:</span> this API is deprecated since July 19, 2018.
 +
 
 +
== Description ==
 +
 
 +
Creates a collection of hashtags to be monitored.
 +
 
 +
== Resource URL ==
 +
 
 +
  POST https://api.socialidnow.com/v1/marketing/selfie/hashtags/create_bulk
 +
 
 +
== Parameters ==
 +
 
 +
=== JSON Parameters ===
 +
 
 +
{|
 +
! align="left" width="180px"  | hashtags
 +
| width="200px" | required
 +
| an array of hashes in format field:value, with the necessary fields to create the hashtags"
 +
|-
 +
! align="left" width="180px"  style="padding-left: 20px" | hashtag
 +
| width="200px" | required
 +
| hashtag to be monitored.
 +
|-
 +
! align="left" width="180px"  style="padding-left: 20px" | name
 +
| width="200px" | required
 +
| reference name of the hashtag.
 +
|-
 +
! align="left" width="180px"  style="padding-left: 20px" | picture_url
 +
| width="200px" | required
 +
| reference picture url of the hashtag.
 +
|}
 +
 
 +
== Authentication ==
 +
 
 +
This API requires Account authentication. See [[Authentication]].
 +
 
 +
== Response ==
 +
 
 +
=== Response Status ===
 +
 
 +
{|
 +
! align="left" width="200px" | ok (200)
 +
| Hashtags were created successfully. If any hashtag is not created the response will hold information concerning its errors.
 +
|-
 +
! align="left" width="200px" | bad_request (400)
 +
| Some required parameter was not informed.
 +
|-
 +
! align="left" width="200px" | unauthorized (401)
 +
| The authentication is wrong. See [[Authentication]].
 +
|-
 +
! align="left" width="200px" | internal_server_error (500)
 +
| An unknown error happened.
 +
|}
 +
 
 +
== Examples ==
 +
 
 +
=== Request ===
 +
 
 +
Creates hashtags "fashion" and "selfie" to be monitored by the application.
 +
 
 +
  curl -iX POST 'https://api.socialidnow.com/v1/marketing/selfie/hashtags/create_bulk' \
 +
        -d '{"hashtags": [
 +
              {"hashtag":"fashion", "name":"Fashion", "picture_url":"http://img2.timeinc.net/people/i/2006/stylechannel/hitormiss/061204/gisele_bundchen300.jpg"}, \
 +
              {"hashtag":"selfie", "name":"Selfie", "picture_url":"http://upload.wikimedia.org/wikipedia/commons/9/90/RobertCornelius.jpg"} \
 +
            ] }' \
 +
        -H 'Content-type:application/json' \
 +
        --user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf
 +
 
 +
=== Response ===
 +
 
 +
==== Response Headers ====
 +
 
 +
HTTP/1.1 200 Ok
 +
Status: 200

Latest revision as of 16:36, 30 December 2021

Deprecation notice: this API is deprecated since July 19, 2018.

Contents

Description

Creates a collection of hashtags to be monitored.

Resource URL 

  POST https://api.socialidnow.com/v1/marketing/selfie/hashtags/create_bulk

Parameters

JSON Parameters

hashtags required an array of hashes in format field:value, with the necessary fields to create the hashtags"
hashtag required hashtag to be monitored.
name required reference name of the hashtag.
picture_url required reference picture url of the hashtag.

Authentication

This API requires Account authentication. See Authentication.

Response

Response Status

ok (200) Hashtags were created successfully. If any hashtag is not created the response will hold information concerning its errors.
bad_request (400) Some required parameter was not informed.
unauthorized (401) The authentication is wrong. See Authentication.
internal_server_error (500) An unknown error happened.

Examples

Request

Creates hashtags "fashion" and "selfie" to be monitored by the application. 

 curl -iX POST 'https://api.socialidnow.com/v1/marketing/selfie/hashtags/create_bulk' \
        -d '{"hashtags": [
              {"hashtag":"fashion", "name":"Fashion", "picture_url":"http://img2.timeinc.net/people/i/2006/stylechannel/hitormiss/061204/gisele_bundchen300.jpg"}, \
              {"hashtag":"selfie", "name":"Selfie", "picture_url":"http://upload.wikimedia.org/wikipedia/commons/9/90/RobertCornelius.jpg"} \
            ] }' \
        -H 'Content-type:application/json' \
        --user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf

Response

Response Headers 

HTTP/1.1 200 Ok
Status: 200
Retrieved from "https://dev.socialidnow.com/index.php?title=POST_selfie/hashtags/create_bulk&oldid=3289"
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox