🔑 MIMS Podcast Tool — API

API ציבורי לקריאת נתונים מהמערכת. גרסה v1, אימות דרך Bearer token.

אימות

כל בקשה דורשת header של Authorization: Bearer <your_api_key>.

צור מפתח חדש בטאב API 🔑 בעמוד הפרופיל. המפתח מוצג פעם אחת בלבד — שמור אותו במקום בטוח.

Endpoints

GET /api/v1/me

מחזיר פרטי המשתמש של מי שהמפתח שלו (שימושי לבדיקת מפתח).

curl -H "Authorization: Bearer mims_..." https://studio.mims.co.il/api/v1/me

תגובה:

{
  "email": "shlomi@mims.co.il",
  "name": "Shlomi Zidkiya",
  "role": "מנהל אולפן",
  "phone": "...",
  "scope": "read"
}

GET /api/v1/projects

רשימת פרקים עם פילטרים ועימוד. פרמטרים אופציונליים:

פרמטר	תיאור
limit	1-200 (ברירת מחדל 50)
offset	לעימוד
folder_id	סינון לפי פודקאסט
status	סטטוס מדויק, או __none__ לפרקים בלי סטטוס
q	חיפוש חופשי בשם/קובץ

curl -H "Authorization: Bearer mims_..." \
  "https://studio.mims.co.il/api/v1/projects?folder_id=1&limit=10"

תגובה:

{
  "total": 18,
  "limit": 10,
  "offset": 0,
  "items": [
    {
      "id": 30,
      "title": "...",
      "filename": "...",
      "created_at": "2026-05-12T08:00:00",
      "folder_id": 1,
      "drive_link": "https://...",
      "has_delivered": true,
      "billing": {"type":"per-episode","amount":800,"paid":false,"invoice_issued":false},
      "latest_status": {"status_text":"נשלח לעריכה","assignee":"שלומי","created_at":"..."}
    }
  ]
}

GET /api/v1/projects/{id}

פרטים מלאים על פרק יחיד — כולל תמלול, SRT, כותרות, פרקים, שורטים, פוסטים, גרסה מעודכנת, תשלומים, וההיסטוריה המלאה של סטטוסים. בנוסף: תוכנית עריכה לפרק המלא (episode_edit), עריכה אוטומטית (auto_edit), שורטים שביקש המשתמש (user_shorts + user_shorts_srts), shorts_srts, פתקי הפקה (production_notes_input/production_notes_text), וכל הקאטים המותאמים והטיזרים (cuts).

curl -H "Authorization: Bearer mims_..." https://studio.mims.co.il/api/v1/projects/30

GET /api/v1/podcasts

רשימת כל הפודקאסטים שיש לך גישה אליהם — עם ספירת פרקים ותשלומים.

curl -H "Authorization: Bearer mims_..." https://studio.mims.co.il/api/v1/podcasts

GET /api/v1/podcasts/{id}

פודקאסט יחיד + רשימת פרקים בו.

curl -H "Authorization: Bearer mims_..." https://studio.mims.co.il/api/v1/podcasts/1

דוגמאות שימוש

Python (requests)

import requests, os
API_KEY = os.environ["MIMS_API_KEY"]
r = requests.get(
    "https://studio.mims.co.il/api/v1/projects",
    headers={"Authorization": f"Bearer {API_KEY}"}
)
print(r.json())

JavaScript (fetch)

const res = await fetch("https://studio.mims.co.il/api/v1/projects", {
  headers: { Authorization: `Bearer ${process.env.MIMS_API_KEY}` }
});
const data = await res.json();

n8n

השתמש ב-HTTP Request node:

• URL: https://studio.mims.co.il/api/v1/projects
• Method: GET
• Authentication: Header Auth → Name: Authorization Value: Bearer mims_...

שגיאות נפוצות

קוד	משמעות
401	missing/invalid/revoked Bearer token
404	משאב לא נמצא או שאין לך גישה
5xx	שגיאת שרת — תוכל לבדוק אצל המנהל

Scopes

לכל מפתח יש scope: read / write / admin. write מאפשר יצירה/עריכה/מחיקה. read מוגבל ל-GET בלבד (יחזיר 403 על פעולות כתיבה).

עריכת פרקים

PATCH /api/v1/projects/{id}

שינוי שם פרק או העברה לפודקאסט אחר. דורש scope write.

curl -X PATCH -H "Authorization: Bearer mims_..." -H "Content-Type: application/json"   -d '{{"title":"כותרת חדשה","folder_id":13}}'   https://studio.mims.co.il/api/v1/projects/30

POST /api/v1/projects/{id}/statuses

הוספת עדכון סטטוס לפרק. status_text חובה, assignee ו-notes אופציונליים.

curl -X POST -H "Authorization: Bearer mims_..." -H "Content-Type: application/json"   -d '{{"status_text":"נשלח לעריכה","assignee":"שלומי","notes":"דחוף"}}'   https://studio.mims.co.il/api/v1/projects/30/statuses

PATCH /api/v1/projects/{id}/statuses/{status_id}

DELETE /api/v1/projects/{id}/statuses/{status_id}

עריכה/מחיקה של עדכון סטטוס קיים.

פודקאסטים

POST /api/v1/podcasts

יצירת פודקאסט חדש. name חובה, השאר אופציונלי.

curl -X POST -H "Authorization: Bearer mims_..." -H "Content-Type: application/json"   -d '{{"name":"פודקאסט חדש","category":"עסקים","description":"...","slug":"new-pod"}}'   https://studio.mims.co.il/api/v1/podcasts

PATCH /api/v1/podcasts/{id}

עדכון פודקאסט קיים. שדות אופציונליים: name, category, description, slug, image_url, visible, status (active/archived).

curl -X PATCH -H "Authorization: Bearer mims_..." -H "Content-Type: application/json"   -d '{{"description":"תיאור מעודכן","visible":false}}'   https://studio.mims.co.il/api/v1/podcasts/1

משימות (Tasks)

GET /api/v1/tasks

רשימת משימות. פילטרים אופציונליים:

פרמטר	תיאור
status	pending / in_progress / done
assignee	אימייל המקבל
context_type	project או folder
context_id	מזהה הקונטקסט
only_mine	1 — רק משימות שלי

POST /api/v1/tasks

יצירת משימה. דורש scope write. title חובה.

curl -X POST -H "Authorization: Bearer mims_..." -H "Content-Type: application/json"   -d '{{"title":"לבדוק פרק","description":"...","assignee_email":"shlomi@mims.co.il","priority":"high","due_date":"2026-05-20","context_type":"project","context_id":30}}'   https://studio.mims.co.il/api/v1/tasks

GET / PATCH / DELETE /api/v1/tasks/{id}

פרטים / עדכון / מחיקה. PATCH יכול לעדכן title, description, assignee_email, status, priority, due_date.

תשלומים (Billing Entries)

מערכת התשלומים — entries עצמאיים עם סטטוסים (pending, payment_request, invoiced, paid).

GET /api/v1/billing/entries

כל הרשימות הנגישות עם שם פודקאסט/פרק. פילטרים: status, context, folder_id.

curl -H "Authorization: Bearer mims_..."   "https://studio.mims.co.il/api/v1/billing/entries?status=pending"

GET /api/v1/billing/entries/{context}/{id}

context = project או folder.

POST /api/v1/billing/entries/{context}/{id}

הוספת חיוב חדש. דורש write.

curl -X POST -H "Authorization: Bearer mims_..." -H "Content-Type: application/json"   -d '{{"amount":800,"description":"4 טיזרים","status":"pending"}}'   https://studio.mims.co.il/api/v1/billing/entries/project/30

PATCH / DELETE /api/v1/billing/entries/{id}

עדכון/מחיקה. עדכון status ל-paid מסמן אוטומטית paid_date.

לידים (Leads / CRM)

ניהול לידים — שדות, סטטוס בצינור, ויומן שיחות. סטטוסים: new, contacted, negotiating, quote_sent, frozen, won, lost, rejected. מקורות: instagram, whatsapp, phone, website, referral, other.

GET /api/v1/leads

רשימת לידים. פילטרים אופציונליים: status, source, q (חיפוש בשם/טלפון/אימייל/מי הפנה/שירות).

curl -H "Authorization: Bearer mims_..." \
  "https://studio.mims.co.il/api/v1/leads?status=new"

POST /api/v1/leads

יצירת ליד (scope=write). חובה: name. אופציונלי: phone, email, source, referrer, service, budget, status, follow_up_date (YYYY-MM-DD), notes.

curl -X POST -H "Authorization: Bearer mims_..." -H "Content-Type: application/json" \
  -d '{"name":"דניאל","source":"whatsapp","referrer":"רינת","service":"צילום פודקאסט"}' \
  https://studio.mims.co.il/api/v1/leads

GET /api/v1/leads/{id}

פרטי ליד מלאים כולל activities (יומן השיחות, מהחדש לישן).

PATCH / DELETE /api/v1/leads/{id}

עדכון שדות/סטטוס/תאריך מעקב, או מחיקה (scope=write). מעבר ל-won/lost/rejected מסמן closed_at.

POST /api/v1/leads/{id}/activities

הוספת סיכום שיחה ליומן (scope=write). גוף: {"summary":"..."}.

curl -X POST -H "Authorization: Bearer mims_..." -H "Content-Type: application/json" \
  -d '{"summary":"שיחה ראשונה — מעוניין בצילום פרק, נשלח הצעה"}' \
  https://studio.mims.co.il/api/v1/leads/12/activities

DELETE /api/v1/leads/{id}/activities/{activity_id}

מחיקת סיכום שיחה (scope=write).

GET /api/v1/leads/count

מספר לידים שדורשים טיפול (חדשים, או שמועד המעקב שלהם היום/באיחור) — לבאדג'.

{ "pending": 3 }

חשבוניות (Invoices)

קריאה של טיוטות/חשבוניות שהופקו, ויצירת טיוטה מחיובים פתוחים. אישור והפקה אמיתית של חשבונית/קבלה במורנינג נשארים ידניים בממשק בלבד — לא נחשפים ב-API.

GET /api/v1/invoices

רשימת טיוטות/חשבוניות. פילטר אופציונלי status (draft, approved, failed, rejected). כולל client_name, סטטוס תשלום, קישורים למסמכים.

curl -H "Authorization: Bearer mims_..." \
  "https://studio.mims.co.il/api/v1/invoices?status=approved"

GET /api/v1/invoices/{id}

טיוטה/חשבונית מלאה כולל שורות, לקוח, סטטוס תשלום וקבלה מקושרת.

POST /api/v1/folders/{id}/invoices

יצירת טיוטת חשבונית מכל החיובים הפתוחים של הפודקאסט (scope=write). דורש חיבור Morning וקישור הפודקאסט ללקוח. לא מפיק כלום במורנינג — רק טיוטה.

curl -X POST -H "Authorization: Bearer mims_..." \
  https://studio.mims.co.il/api/v1/folders/1/invoices

POST /api/v1/projects/{id}/invoices

כנ"ל, אבל מהחיובים הפתוחים של פרק בודד (scope=write).

יומן (Calendar / Calendly)

ניהול יומן האולפן מול חשבון ה-Calendly המחובר (הגדרות ← יומן). כל הזמנים ב-ISO-8601 UTC. החיבור מזוהה לפי בעל סביבת העבודה. אם היומן לא מחובר — מוחזר 412 עם {"error":"calendly_not_connected"}.

GET /api/v1/calendly/connection

סטטוס החיבור: connected, ואם כן owner_name, owner_email, timezone, scheduling_url, last_verified_at.

GET /api/v1/calendly/event-types

השירותים הפעילים (סוגי הקלטה): uri, name, duration, duration_options, description, location_kind.

GET /api/v1/calendly/events

אירועים מתוזמנים. פילטרים: status (active ברירת מחדל / canceled), from, to (ISO; ברירת מחדל ‎-30 עד +120 יום). כל אירוע כולל start_time, end_time, name, location, ו-invitee ({name, email, phone} — טלפון best-effort).

curl -H "Authorization: Bearer mims_..." \
  "https://studio.mims.co.il/api/v1/calendly/events?status=active"

GET /api/v1/calendly/availability

מועדים פנויים לשירות. חובה event_type (ה-uri מ-event-types). אופציונלי from/to (החלון נחתך אוטומטית ל-7 ימים ולעתיד בלבד — מגבלת Calendly). מחזיר slots: [{iso, scheduling_url, invitees_remaining}].

curl -H "Authorization: Bearer mims_..." \
  "https://studio.mims.co.il/api/v1/calendly/availability?event_type=https://api.calendly.com/event_types/XXX&from=2026-05-18T00:00:00Z"

GET /api/v1/calendly/clients

לקוחות קודמים (אגרגציה מ-invitees של אירועים + טלפונים שנשמרו מקומית). מחזיר clients: [{name, email, phone, count}] ממוין לפי תדירות. נשמר ב-cache ל-15 דק׳; ?refresh=1 מאלץ רענון.

POST /api/v1/calendly/events

קביעת אירוע ללקוח (scope=write). חובה: event_type_uri, start_time (ISO/UTC), name, email. אופציונלי: duration, phone, guests (מערך אימיילים או אובייקטים {name,email,phone} — ל-Calendly נשלחים רק אימיילים, השאר נשמר מקומית), location_kind (physical / ask_invitee), location_text (חובה כש-ask_invitee). הטלפונים נשמרים מקומית ומאכלסים אוטומטית את clients בעתיד.

curl -X POST -H "Authorization: Bearer mims_..." -H "Content-Type: application/json" \
  -d '{"event_type_uri":"https://api.calendly.com/event_types/XXX","start_time":"2026-05-20T08:00:00Z","duration":60,"name":"דניאל","email":"d@x.com","phone":"0521234567"}' \
  https://studio.mims.co.il/api/v1/calendly/events

POST /api/v1/calendly/events/cancel

ביטול אירוע (scope=write). חובה event_uri (URL של api.calendly.com), אופציונלי reason (נשלח ללקוח).

curl -X POST -H "Authorization: Bearer mims_..." -H "Content-Type: application/json" \
  -d '{"event_uri":"https://api.calendly.com/scheduled_events/XXX","reason":"נדחה לבקשת הלקוח"}' \
  https://studio.mims.co.il/api/v1/calendly/events/cancel

הוצאות (Expenses)

דוח הוצאות מאגד הנמשך מ-Morning (חשבונית ירוקה). דורש חיבור Morning פעיל (אחרת 412 {"error":"morning_not_connected"}). הנתונים מחושבים בצד השרת ונשמרים ב-cache ל-15 דק׳.

GET /api/v1/expenses/summary

סיכום הוצאות. פרמטר אופציונלי months (3–24, ברירת מחדל 12), refresh=1 לרענון מאולץ. מחזיר: totals (this_month, last_month, ytd, all_window, avg_month, vat, net), monthly[] (סדרה חודשית), by_classification[] (לפי סיווג חשבונאי), by_supplier[] (ספקים מובילים), by_payment_type[], fixed_variable (קבוע מול משתנה — היוריסטיקה: ספק שחוזר ב-3+ חודשים נחשב קבוע, כולל recurring_suppliers[]), ו-recent[] (40 ההוצאות האחרונות עם קישור למסמך).

curl -H "Authorization: Bearer mims_..." \
  "https://studio.mims.co.il/api/v1/expenses/summary?months=12"

העלאת פרק חדש (Episodes)

העלאת קובץ אודיו/וידאו לתמלול ולניתוח אוטומטי על-ידי Claude — בדיוק כמו הטופס באתר. דורש scope=write. הבקשה מסוג multipart/form-data.

POST /api/v1/episodes/process

שולח קובץ או לינק Google Drive, מקבל מיידית job_id לעקיבה. העיבוד רץ ברקע.

שדות (multipart/form-data):

שדה	חובה	תיאור
file	* אחד מהשניים	קובץ אודיו/וידאו (mp3, mp4, m4a, wav, וכו׳). עד 10GB.
drive_url	* אחד מהשניים	לינק Google Drive ציבורי (Anyone with the link). השתמש כש אין קובץ מקומי.
filename	אופציונלי	שם תצוגה. אם משתמשים ב-drive_url ולא צוין — ייקרא input.mp4.
project_title	אופציונלי	כותרת הפרק. אם ריק — Claude יציע כותרות.
production_notes	אופציונלי	פתקי הפקה (טקסט חופשי). יופעל ניתוח שני: user_shorts + episode_edit.
edit_level	אופציונלי	עריכה אוטומטית של הפרק כשאין עריכות ידניות בפתקים: none (ברירת מחדל ב-API), basic, partial, aggressive. מפיק auto_edit (הסרות+סיכום) ו-episode_edit (הקטעים שנשארים).
folder_id	אופציונלי	ID של פודקאסט קיים לשייך אליו (חייב גישה).
assignee_email	אופציונלי	אימייל מי שאחראי על הפרק (יווצר סטטוס "חדש" עם השם שלו).
amount	אופציונלי	סכום ראשוני לחיוב (ILS) — יוצר billing entry.
existing_project_id	אופציונלי	ID של פרק קיים שעוד לא תומלל — יעדכן אותו במקום ליצור חדש.
transcription_model	אופציונלי	ברירת מחדל elevenlabs.

curl -X POST -H "Authorization: Bearer mims_..." \
  -F "file=@episode.mp3" \
  -F "project_title=פרק 47" \
  -F "folder_id=3" \
  -F "production_notes=לקצר את הפתיח" \
  https://studio.mims.co.il/api/v1/episodes/process

תגובה (מיידית):

{ "job_id": "5cf36eae-fc9e-482c-9426-ef913519b03c" }

או עם Google Drive:

curl -X POST -H "Authorization: Bearer mims_..." \
  -F "drive_url=https://drive.google.com/file/d/ABC123/view" \
  -F "filename=episode.mp4" \
  -F "project_title=פרק 47" \
  https://studio.mims.co.il/api/v1/episodes/process

GET /api/v1/episodes/jobs/{job_id}

polling לסטטוס. עשה קריאה כל 5–10 שניות עד שהסטטוס done או error. ניתן לראות רק jobs ששלך (משתמשים אחרים יקבלו 404).

curl -H "Authorization: Bearer mims_..." \
  https://studio.mims.co.il/api/v1/episodes/jobs/5cf36eae-fc9e-482c-9426-ef913519b03c

סטטוסים אפשריים: queued → transcribing → analyzing → uploading → done (או error).

תגובה בזמן עיבוד:

{ "status": "analyzing", "status_text": "קלוד מנתח את הפרק..." }

תגובה בסיום (status=done):

{
  "status": "done",
  "status_text": "...",
  "result": {
    "project_id": 123,
    "title": "...",
    "filename": "episode.mp3",
    "transcript": "טקסט מלא...",
    "full_srt": "1\n00:00:00,000 --> ...",
    "words": [{"word":"שלום","start":0.0,"end":0.4}, ...],
    "titles": ["...", "...", "..."],
    "description": "...",
    "chapters": [{"title":"פתיח","start":0,"end":120}, ...],
    "shorts": [{"title":"...","start":...,"end":...,"reason":"..."}],
    "shorts_srts": ["...", ...],
    "social_posts": {"instagram":"...","linkedin":"...","x":"..."},
    "quotes": ["...", "..."],
    "content_warnings": "...",
    "episode_edit": [{"number":1,"in_time":"00:00:00","out_time":"00:12:30","description":""}],
    "auto_edit": {"level":"basic","summary":"הוסרו שתיקות ומילים מיותרות, ~3 דק׳","removals":[{"in_time":"00:04:10","out_time":"00:04:25","reason":"שתיקה ארוכה"}]}
  }
}

episode_edit/auto_edit מופיעים רק כששלחת edit_level (או production_notes עם עצירות). user_shorts מופיע כששלחת production_notes.

שגיאות: 400 — חסר קובץ או לינק תקין; 401 — מפתח לא תקין; 403 — אין גישה ל-folder/project; 404 — project לא קיים או שהוא כבר תומלל.

שדות נוספים בקריאה

החל מעכשיו, ה-GET endpoints הקיימים כוללים גם:

Endpoint	שדות חדשים
/api/v1/projects (list)	billing_entries
/api/v1/projects/{{id}}	billing_entries, tasks, episode_edit, auto_edit, user_shorts, user_shorts_srts, shorts_srts, production_notes_input, production_notes_text, cuts
/api/v1/podcasts (list)	billing_entries
/api/v1/podcasts/{{id}}	billing_entries, tasks

השדה billing הישן (billing_json) עדיין מוחזר לתאימות לאחור.

MIMS Podcast Tool · studio.mims.co.il