Obtener una publicación

Recupera una publicación por su Ayrshare Post ID

GET /post/:id

cURL

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl

const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl", {
      method: "GET",
      headers: {
        "Authorization": `Bearer ${API_KEY}`
      }
    })
      .then((res) => res.json())
      .then((json) => console.log(json))
      .catch(console.error);

import requests

headers = {'Authorization': 'Bearer API_KEY'}

r = requests.get('https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl', headers=headers)

print(r.json())

<?php

// URL and authorization details
$url = 'https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl';
$apiKey = 'API_KEY';  // Replace 'API_KEY' with your actual API key

// Initialize a cURL session
$curl = curl_init();

// Set cURL options
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey
));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

// Execute cURL session and get the response
$response = curl_exec($curl);

// Check if any error occurred
if(curl_errno($curl)){
    echo 'Curl error: ' . curl_error($curl);
} else {
    // Decode and re-encode the JSON response to pretty print
    echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}

// Close cURL session
curl_close($curl);

using System;
using System.Net.Http;
using System.Threading.Tasks;

namespace PostGETRequest_csharp
{
    class Post
    {
        private static readonly HttpClient client = new HttpClient();

        static async Task Main(string[] args)
        {
            string API_KEY = "API_KEY";
            string url = "https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl";

            // Set up request headers
            client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);
            client.DefaultRequestHeaders.Accept.Add(new System.Net.Http.Headers.MediaTypeWithQualityHeaderValue("application/json"));

            try
            {
                // Send GET request and read response
                HttpResponseMessage response = await client.GetAsync(url);
                response.EnsureSuccessStatusCode();
                
                string responseBody = await response.Content.ReadAsStringAsync();
                Console.WriteLine(responseBody);
            }
            catch (HttpRequestException e)
            {
                Console.WriteLine($"Error: {e.Message}");
            }
        }
    }
}

200: Success

{
    "created": "2024-11-19T19:00:14Z",
    "errors": [],
    "id": "8tNTr73VV8Y66bHwC2322",
    "mediaUrls": [
        "https://img.ayrshare.com/012/gb.jpg"
    ],
    "platforms": [
        "twitter"
    ],
    "post": "#75304 Eighty percent of success is showing up. - John D. Rockefeller",
    "postIds": [
        {
            "status": "success",
            "id": "1858948421974925758",
            "postUrl": "https://twitter.com/wondrouswaffles/status/185894842197493444",
            "platform": "twitter"
        }
    ],
    "profileTitle": "Best Profile",
    "refId": "b68bdcabb379be2cf1186c1e59544",
    "scheduleDate": "2024-11-19T19:00:14Z",
    "shortenLinks": false,
    "status": "success",
    "type": "now"
}

{
    "action": "history",
    "status": "error",
    "code": 221,
    "message": "History not found.",
    "id": "4W3f3RPr6QSrw8S5Yo8"
}

Obtén el historial de una publicación concreta enviada a través de Ayrshare. Devuelve el estado, los parámetros de la publicación y otros detalles. Sustituye :id por el Ayrshare Post ID.

Llama al endpoint /history by id para obtener los mismos datos.

​

Estados de la publicación

A continuación se muestran los estados que se devuelven para una publicación.

Estado	Descripción
awaiting approval	Las publicaciones están a la espera de aprobación mediante el flujo de aprobación.
deleted	La publicación se ha eliminado. Nota: las publicaciones eliminadas solo se devuelven con el filtro de consulta por estado. Consulta más abajo.
error	Se produjo un error en una o más redes sociales.
pending	La publicación aún no se ha procesado. Normalmente una publicación programada.
success	La publicación se envió correctamente a todas las redes sociales.

Consulta el endpoint /history para recuperar todas las publicaciones, incluidas las que no se han enviado a través de Ayrshare.

​

Parámetros de cabecera

​

Parámetros de ruta

id · string · requerido

Ayrshare Post ID obtenido de /post

cURL

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl

const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl", {
      method: "GET",
      headers: {
        "Authorization": `Bearer ${API_KEY}`
      }
    })
      .then((res) => res.json())
      .then((json) => console.log(json))
      .catch(console.error);

import requests

headers = {'Authorization': 'Bearer API_KEY'}

r = requests.get('https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl', headers=headers)

print(r.json())

<?php

// URL and authorization details
$url = 'https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl';
$apiKey = 'API_KEY';  // Replace 'API_KEY' with your actual API key

// Initialize a cURL session
$curl = curl_init();

// Set cURL options
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey
));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

// Execute cURL session and get the response
$response = curl_exec($curl);

// Check if any error occurred
if(curl_errno($curl)){
    echo 'Curl error: ' . curl_error($curl);
} else {
    // Decode and re-encode the JSON response to pretty print
    echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}

// Close cURL session
curl_close($curl);

using System;
using System.Net.Http;
using System.Threading.Tasks;

namespace PostGETRequest_csharp
{
    class Post
    {
        private static readonly HttpClient client = new HttpClient();

        static async Task Main(string[] args)
        {
            string API_KEY = "API_KEY";
            string url = "https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl";

            // Set up request headers
            client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);
            client.DefaultRequestHeaders.Accept.Add(new System.Net.Http.Headers.MediaTypeWithQualityHeaderValue("application/json"));

            try
            {
                // Send GET request and read response
                HttpResponseMessage response = await client.GetAsync(url);
                response.EnsureSuccessStatusCode();
                
                string responseBody = await response.Content.ReadAsStringAsync();
                Console.WriteLine(responseBody);
            }
            catch (HttpRequestException e)
            {
                Console.WriteLine($"Error: {e.Message}");
            }
        }
    }
}

200: Success

{
    "created": "2024-11-19T19:00:14Z",
    "errors": [],
    "id": "8tNTr73VV8Y66bHwC2322",
    "mediaUrls": [
        "https://img.ayrshare.com/012/gb.jpg"
    ],
    "platforms": [
        "twitter"
    ],
    "post": "#75304 Eighty percent of success is showing up. - John D. Rockefeller",
    "postIds": [
        {
            "status": "success",
            "id": "1858948421974925758",
            "postUrl": "https://twitter.com/wondrouswaffles/status/185894842197493444",
            "platform": "twitter"
        }
    ],
    "profileTitle": "Best Profile",
    "refId": "b68bdcabb379be2cf1186c1e59544",
    "scheduleDate": "2024-11-19T19:00:14Z",
    "shortenLinks": false,
    "status": "success",
    "type": "now"
}

{
    "action": "history",
    "status": "error",
    "code": 221,
    "message": "History not found.",
    "id": "4W3f3RPr6QSrw8S5Yo8"
}