Перейти до вмісту
shareto

ShareTo API

Публікуйте зі свого коду

Один REST API, щоб під’єднувати акаунти й публікувати або планувати дописи в Instagram, Facebook, YouTube, LinkedIn і TikTok. Створюйте стільки API-ключів, скільки потрібно.

Базова адресаhttps://shareto.social/api/v1

  1. Автентифікація

    Створіть ключ у Налаштуваннях, розділ API, і надсилайте його як Bearer-токен у кожному запиті. Ключів можна мати скільки завгодно, кожен показується лише раз, і його можна відкликати будь-коли.

    curl https://shareto.social/api/v1/accounts \
      -H "Authorization: Bearer st_live_..."
  2. Під’єднання акаунта

    Запросіть посилання для під’єднання й відкрийте його в браузері або надішліть власнику акаунта. Він дає дозвіл на платформі й повертається на ваш redirectUrl. Посилання діє 30 хвилин.

    curl -X POST https://shareto.social/api/v1/accounts/connect \
      -H "Authorization: Bearer st_live_..." \
      -H "Content-Type: application/json" \
      -d '{ "platform": "tiktok", "redirectUrl": "https://example.com/done" }'
    
    # 201
    { "data": { "url": "https://shareto.social/api/connect/tiktok?t=...",
                "expiresAt": "2026-11-10T10:30:00.000Z" } }
  3. Завантаження медіа

    Отримайте дозвіл на завантаження й надішліть файл методом PUT на putUrl. Великі відео можна докачувати через tus. Використайте отриманий url у дописі.

    curl -X POST https://shareto.social/api/v1/uploads \
      -H "Authorization: Bearer st_live_..." \
      -H "Content-Type: application/json" \
      -d '{ "filename": "launch.mp4", "contentType": "video/mp4" }'
    
    curl -X PUT "$PUT_URL" \
      -H "Authorization: Bearer $UPLOAD_TOKEN" \
      -H "Content-Type: video/mp4" \
      --data-binary @launch.mp4
  4. Публікація або планування

    Надішліть текст, медіа й ідентифікатори акаунтів. Залиште scheduledAt порожнім, щоб опублікувати одразу, або вкажіть час у форматі ISO, щоб запланувати. Кожен акаунт має власний статус.

    curl -X POST https://shareto.social/api/v1/posts \
      -H "Authorization: Bearer st_live_..." \
      -H "Content-Type: application/json" \
      -d '{
        "kind": "reel",
        "caption": "Behind the scenes",
        "media": [{ "url": "$MEDIA_URL", "type": "video" }],
        "accountIds": ["$ACCOUNT_ID"],
        "scheduledAt": "2026-11-12T09:00:00Z"
      }'

Ендпоїнти

МетодШляхЩо робить
GET/accountsСписок під’єднаних акаунтів
GET/accounts/{id}Отримати один акаунт
POST/accounts/connectСтворити посилання для під’єднання платформи
DELETE/accounts/{id}Від’єднати акаунт і скасувати його заплановані дописи
POST/uploadsОтримати одноразовий дозвіл на завантаження файлу
POST/postsОпублікувати одразу або запланувати допис
GET/posts?ids=a,bОтримати останні 50 дописів або ті, що вказані в ids
GET/posts/{id}Отримати допис зі статусом кожного акаунта
DELETE/posts/{id}Видалити допис, який ще не опубліковано

Способи під’єднання

Акаунт під’єднується через Zernio, партнерський API для публікацій, чиї застосунки платформи схвалили для публічних дописів, або напряму через власні застосунки ShareTo. Передайте connection зі значенням auto, zernio або direct; auto обирає спосіб для кожної платформи.

Помилки

Помилки приходять як JSON із полем message: 401, якщо ключа немає або він неправильний, 404, якщо запису немає у вашому робочому просторі, 422, якщо запит порушує правило платформи. Повідомлення підказує, що змінити.

ShareTo у закритій беті. Попросіть доступ, щоб відкрити робочий простір.