Web sitesi API

Ziyaretçilerin sitenizde okuduğu sayfalar, yazılar, sık sorulan sorular ve yasal metinler.

Modül kodu site · 76 işlem · 22 veri modeli · 44 olay. Bir anahtar ya da token, arkasındaki kişinin bu modülde yapabildiğinden fazlasını asla yapamaz; satır düzeyindeki güvenlik uygulamadakiyle birebir aynıdır. Yetki kapsamları: site (hepsi), site:read (yalnız okuma) ya da site:<yetenek>.

Kaynaklar

Listeler limit (en çok 200), cursor, order (ör. -created_at), fields ve q alır; diğer her sorgu parametresi bir sütun süzgecidir: ?status=paid, ?total[gte]=100, ?id[in]=a,b, ?x=null.

İşlemler

site.add_domain

Adres ekle — Site için bir alan adı talep eder ve sahipliği kanıtlayan kaydı üretir.

Gereken izin site:manage · veriyi değiştirir

• REST kısayolu: POST /api/v1/domains
• Asıl adres: POST /api/v1/actions/site.add_domain

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.domain_added

Neye yazar: domain (insert) — Registers it pending, with a verification token

curl -X POST https://app.getera.io/api/v1/domains/actions/add_domain \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"siteId":"SITE_ID","host":"Hostname"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.domain_added"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.domains.create({
  siteId: "SITE_ID",
  host: "Hostname"
})

era domains create \
  --site-id "SITE_ID" \
  --host "Hostname"

{
  "name": "era__site__add_domain",
  "arguments": {
    "siteId": "SITE_ID",
    "host": "Hostname"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 site_not_found, invalid_host, platform_domain, host_taken · 429 çok sık istek

site.add_page_block

Sayfaya bölüm ekle — Taslak temadaki bir sayfaya tek bir bölüm ekler.

Gereken izin site:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/site.add_page_block

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.blocks_changed

Neye yazar: theme (update) — Adds one block to config.pageBlocks

curl -X POST https://app.getera.io/api/v1/themes/THEME_ID/actions/add_page_block \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"pageId":"PAGE_ID","blockId":"Section","type":"Block type","data":{}}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.blocks_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.themes.addPageBlock("THEME_ID", {
  pageId: "PAGE_ID",
  blockId: "Section",
  type: "Block type",
  data: {}
})

era themes add_page_block THEME_ID --data '{"pageId":"PAGE_ID","blockId":"Section","type":"Block type","data":{}}'

{
  "name": "era__site__add_page_block",
  "arguments": {
    "themeId": "THEME_ID",
    "pageId": "PAGE_ID",
    "blockId": "Section",
    "type": "Block type",
    "data": {}
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 theme_not_found, theme_is_published, archived, page_not_found, invalid_blocks, duplicate_block_id · 429 çok sık istek

site.add_section

Sayfaya bölüm ekle — Sitenin taslağında bir sayfaya yeni bölüm ekler — ziyaretçiler yayımladıktan sonra görür.

Gereken izin site:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/site.add_section

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.blocks_changed, site.theme_draft_created

Neye yazar: theme (update) — Changes one page of the site’s draft (a draft is forked from the live theme when there is none); theme_snapshot (insert) — Keeps an automatic checkpoint of the draft before the change; theme (insert) — Starts a draft when the site has none

curl -X POST https://app.getera.io/api/v1/theme_snapshots/actions/add_section \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"type":"Kind of section"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.blocks_changed",
    "site.theme_draft_created"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.themeSnapshots.addSection({
  type: "Kind of section"
})

era theme_snapshots add_section \
  --type "Kind of section"

{
  "name": "era__site__add_section",
  "arguments": {
    "type": "Kind of section"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 site_not_found, page_not_found, unknown_block_type, block_not_found, invalid_blocks · 429 çok sık istek

site.assign_images

Görsel ata — Seçili içeriklere aynı kapak görselini koyar; diğer alanlar korunur.

Gereken izin site:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/site.assign_images

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.post_saved, site.news_saved, site.reference_saved

Neye yazar: blog_post (update) — Sets the cover image without replacing content; news (update) — Sets the cover image without replacing content; client_reference (update) — Sets the cover image without replacing content

curl -X POST https://app.getera.io/api/v1/blog_posts/actions/assign_images \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"ids":{},"fileId":"FILE_ID","contentType":"blog"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.post_saved",
    "site.news_saved",
    "site.reference_saved"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.blogPosts.assignImages({
  ids: {},
  fileId: "FILE_ID",
  contentType: "blog"
})

era blog_posts assign_images --data '{"ids":{},"fileId":"FILE_ID","contentType":"blog"}'

{
  "name": "era__site__assign_images",
  "arguments": {
    "ids": {},
    "fileId": "FILE_ID",
    "contentType": "blog"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 no_items, file_not_found, image_required, not_found · 429 çok sık istek

site.cancel_scheduled_content

Zamanlanmış yayımlamayı iptal et — Yazıyı taslak olarak bırakır ve bekleyen yayımlamayı iptal eder.

Gereken izin site:write · siler ya da geri alınamaz

• Asıl adres: POST /api/v1/actions/site.cancel_scheduled_content

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: blog_post (update) — Clears a post schedule; news (update) — Clears a news schedule

curl -X POST https://app.getera.io/api/v1/blog_posts/actions/cancel_scheduled_content \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"id":"ID_ID","kind":"post"}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.blogPosts.cancelScheduledContent({
  id: "ID_ID",
  kind: "post"
})

era blog_posts cancel_scheduled_content \
  --id "ID_ID" \
  --kind "post"

{
  "name": "era__site__cancel_scheduled_content",
  "arguments": {
    "id": "ID_ID",
    "kind": "post"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_scheduled · 429 çok sık istek

site.cancel_theme_schedule

Tema zamanlamasını iptal et — Taslağı taslak olarak bırakır ve bekleyen yayımlamayı iptal eder.

Gereken izin site:manage · siler ya da geri alınamaz

• Asıl adres: POST /api/v1/actions/site.cancel_theme_schedule

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.theme_scheduled

Neye yazar: theme (update) — Clears the schedule

curl -X POST https://app.getera.io/api/v1/themes/THEME_ID/actions/cancel_theme_schedule \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.theme_scheduled"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.themes.cancelThemeSchedule("THEME_ID")

era themes cancel_theme_schedule THEME_ID

{
  "name": "era__site__cancel_theme_schedule",
  "arguments": {
    "themeId": "THEME_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_scheduled · 429 çok sık istek

site.create_page

Sayfa ekle — Sitede taslak olarak ve menü dışında yeni bir sayfa.

Gereken izin site:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/site.create_page

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.page_created

Neye yazar: page (insert) — Creates the page as a draft

curl -X POST https://app.getera.io/api/v1/pages/PAGE_ID/actions/create_page \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"siteId":"SITE_ID","title":"Title"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.page_created"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.pages.createPage("PAGE_ID", {
  siteId: "SITE_ID",
  title: "Title"
})

era pages create_page PAGE_ID \
  --site-id "SITE_ID" \
  --title "Title"

{
  "name": "era__site__create_page",
  "arguments": {
    "parentId": "PAGE_ID",
    "siteId": "SITE_ID",
    "title": "Title"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 site_not_found, slug_taken, parent_not_found · 429 çok sık istek

site.create_site

Site oluştur — Bu çalışma alanının herkese açık yüzü; yanıt verdiği platform adresiyle.

Gereken izin site:manage · veriyi değiştirir

• REST kısayolu: POST /api/v1/sites
• Asıl adres: POST /api/v1/actions/site.create_site

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.created

Neye yazar: site (insert) — Creates the site, unpublished; domain (insert) — Issues its platform address, already verified

curl -X POST https://app.getera.io/api/v1/sites/actions/create_site \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"name":"Name"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.created"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.sites.create({
  name: "Name"
})

era sites create \
  --name "Name"

{
  "name": "era__site__create_site",
  "arguments": {
    "name": "Name"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 invalid_slug, slug_taken, host_taken · 429 çok sık istek

site.create_theme_draft

Taslak başlat — Üzerinde çalışmak için yayındaki temanın bir kopyası; ziyaretçiler düzenlemenizi izlemez.

Gereken izin site:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/site.create_theme_draft

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.theme_draft_created

Neye yazar: theme (insert) — Forks the live theme into a draft

curl -X POST https://app.getera.io/api/v1/themes/actions/create_theme_draft \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"siteId":"SITE_ID"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.theme_draft_created"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.themes.createThemeDraft({
  siteId: "SITE_ID"
})

era themes create_theme_draft \
  --site-id "SITE_ID"

{
  "name": "era__site__create_theme_draft",
  "arguments": {
    "siteId": "SITE_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 site_not_found, draft_exists · 429 çok sık istek

site.define_content

Sitenin kullandığı içeriği tanımla — Bir kod sitesinin bağlandığı düzenlenebilir içerikleri (yazı, görsel, bağlantı, çalışma saatleri, listeler) oluşturur ya da günceller. Sahibin değiştirdiği değerler, üzerine yaz seçilmedikçe korunur.

Gereken izin site:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/site.define_content

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.content_changed

Neye yazar: site_content (insert) — New entries; site_content (update) — Label, kind and section of existing entries; empty languages filled in

curl -X POST https://app.getera.io/api/v1/site_contents/actions/define_content \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"siteId":"SITE_ID","entries":{}}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.content_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.siteContents.defineContent({
  siteId: "SITE_ID",
  entries: {}
})

era site_contents define_content --data '{"siteId":"SITE_ID","entries":{}}'

{
  "name": "era__site__define_content",
  "arguments": {
    "siteId": "SITE_ID",
    "entries": {}
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 site_not_found, invalid_content · 429 çok sık istek

site.delete_blog_taxonomy

Blog kategorisini, etiketini veya yazarını sil — Kullanılmayan bir blog kategorisini, etiketini veya yazarını kaldırır. Önce yazıların taşınması gerekir.

Gereken izin site:manage · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/site.delete_blog_taxonomy

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.blog_taxonomy_changed

Neye yazar: blog_category (delete) — Deletes an unused category; blog_tag (delete) — Deletes an unused tag; blog_author (delete) — Deletes an unused author

curl -X POST https://app.getera.io/api/v1/blog_categories/actions/delete_blog_taxonomy \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"id":"ID_ID","kind":"category"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.blog_taxonomy_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.blogCategories.deleteBlogTaxonomy({
  id: "ID_ID",
  kind: "category"
})

era blog_categories delete_blog_taxonomy \
  --id "ID_ID" \
  --kind "category"

{
  "name": "era__site__delete_blog_taxonomy",
  "arguments": {
    "id": "ID_ID",
    "kind": "category"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 category_not_found, tag_not_found, author_not_found, blog_category_in_use, blog_tag_in_use, blog_author_in_use · 429 çok sık istek

site.delete_content

İçeriği kaldır — Sitenin artık kullanmadığı bir içeriği kaldırır.

Gereken izin site:manage · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/site.delete_content

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.content_changed

Neye yazar: site_content (delete) — The entry

curl -X POST https://app.getera.io/api/v1/site_contents/actions/delete_content \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"siteId":"SITE_ID","key":"Entry"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.content_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.siteContents.deleteContent({
  siteId: "SITE_ID",
  key: "Entry"
})

era site_contents delete_content \
  --site-id "SITE_ID" \
  --key "Entry"

{
  "name": "era__site__delete_content",
  "arguments": {
    "siteId": "SITE_ID",
    "key": "Entry"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 site_not_found, content_not_found · 429 çok sık istek

site.delete_faq_category

SSS grubunu kaldır — Grubu kaldırır ve sorularını grupsuz bırakır.

Gereken izin site:delete · siler ya da geri alınamaz

• REST kısayolu: DELETE /api/v1/faq_categories/{id}
• Asıl adres: POST /api/v1/actions/site.delete_faq_category

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.faq_changed

Neye yazar: faq_category (delete) — Removes the group; faq_item (update) — Leaves its questions ungrouped through the foreign key

curl -X POST https://app.getera.io/api/v1/faq_categories/FAQ_CATEGORY_ID/actions/delete_faq_category \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.faq_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.faqCategories.deleteFaqCategory("FAQ_CATEGORY_ID")

era faq_categories delete_faq_category FAQ_CATEGORY_ID

{
  "name": "era__site__delete_faq_category",
  "arguments": {
    "id": "FAQ_CATEGORY_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:delete izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 category_not_found · 429 çok sık istek

site.delete_faq_item

SSS sorusunu kaldır — Bir soruyu sitedeki akordeondan kaldırır.

Gereken izin site:delete · siler ya da geri alınamaz

• REST kısayolu: DELETE /api/v1/faq_items/{id}
• Asıl adres: POST /api/v1/actions/site.delete_faq_item

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.faq_changed

Neye yazar: faq_item (delete) — Removes the question

curl -X POST https://app.getera.io/api/v1/faq_items/FAQ_ITEM_ID/actions/delete_faq_item \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.faq_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.faqItems.deleteFaqItem("FAQ_ITEM_ID")

era faq_items delete_faq_item FAQ_ITEM_ID

{
  "name": "era__site__delete_faq_item",
  "arguments": {
    "id": "FAQ_ITEM_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:delete izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 faq_item_not_found · 429 çok sık istek

site.delete_page

Sayfayı sil — Kalıcı olarak gider. Siteyle gelen sayfalar yalnızca arşivlenebilir.

Gereken izin site:delete · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• REST kısayolu: DELETE /api/v1/pages/{id}
• Asıl adres: POST /api/v1/actions/site.delete_page

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.page_deleted

Neye yazar: page (delete) — Removes the page

curl -X POST https://app.getera.io/api/v1/pages/PAGE_ID/actions/delete_page \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.page_deleted"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.pages.deletePage("PAGE_ID")

era pages delete_page PAGE_ID

{
  "name": "era__site__delete_page",
  "arguments": {
    "id": "PAGE_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:delete izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 page_not_found, page_is_default, homepage_must_stay_published, has_children · 429 çok sık istek

site.delete_redirect

Yönlendirmeyi kaldır — Eski adres yeniden “bulunamadı” döndürmeye başlar.

Gereken izin site:manage · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/site.delete_redirect

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.redirect_changed

Neye yazar: page_redirect (delete) — Removes the redirect

curl -X POST https://app.getera.io/api/v1/page_redirects/PAGE_REDIRECT_ID/actions/delete_redirect \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.redirect_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.pageRedirects.deleteRedirect("PAGE_REDIRECT_ID")

era page_redirects delete_redirect PAGE_REDIRECT_ID

{
  "name": "era__site__delete_redirect",
  "arguments": {
    "id": "PAGE_REDIRECT_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 redirect_not_found · 429 çok sık istek

site.delete_reference

Referansı kaldır — Bir müşteri projesini ve yorumunu siteden kaldırır.

Gereken izin site:delete · siler ya da geri alınamaz

• Asıl adres: POST /api/v1/actions/site.delete_reference

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.reference_deleted

Neye yazar: client_reference (delete) — Removes the reference

curl -X POST https://app.getera.io/api/v1/client_references/CLIENT_REFERENCE_ID/actions/delete_reference \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.reference_deleted"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.clientReferences.deleteReference("CLIENT_REFERENCE_ID")

era client_references delete_reference CLIENT_REFERENCE_ID

{
  "name": "era__site__delete_reference",
  "arguments": {
    "id": "CLIENT_REFERENCE_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:delete izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 reference_not_found · 429 çok sık istek

site.edit_page_block

Sayfa bölümünü düzenle — Bir bölümün içeriğini, türünü veya görünürlüğünü değiştirir.

Gereken izin site:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/site.edit_page_block

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.blocks_changed

Neye yazar: theme (update) — Edits one block in config.pageBlocks

curl -X POST https://app.getera.io/api/v1/themes/THEME_ID/actions/edit_page_block \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"pageId":"PAGE_ID","blockId":"Section"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.blocks_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.themes.editPageBlock("THEME_ID", {
  pageId: "PAGE_ID",
  blockId: "Section"
})

era themes edit_page_block THEME_ID \
  --page-id "PAGE_ID" \
  --block-id "Section"

{
  "name": "era__site__edit_page_block",
  "arguments": {
    "themeId": "THEME_ID",
    "pageId": "PAGE_ID",
    "blockId": "Section"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 theme_not_found, theme_is_published, archived, page_not_found, block_not_found, invalid_blocks, duplicate_block_id · 429 çok sık istek

site.edit_section

Bölümü düzenle — Bir bölümün yazılarını, görselini, ayarlarını ya da görünürlüğünü taslakta değiştirir.

Gereken izin site:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/site.edit_section

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.blocks_changed, site.theme_draft_created

Neye yazar: theme (update) — Changes one page of the site’s draft (a draft is forked from the live theme when there is none); theme_snapshot (insert) — Keeps an automatic checkpoint of the draft before the change; theme (insert) — Starts a draft when the site has none

curl -X POST https://app.getera.io/api/v1/theme_snapshots/actions/edit_section \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"section":"Section"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.blocks_changed",
    "site.theme_draft_created"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.themeSnapshots.editSection({
  section: "Section"
})

era theme_snapshots edit_section \
  --section "Section"

{
  "name": "era__site__edit_section",
  "arguments": {
    "section": "Section"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 site_not_found, page_not_found, block_not_found, invalid_path, invalid_image, invalid_device, invalid_blocks, nothing_to_change · 429 çok sık istek

site.finish_deploy

Yayın sonucunu kaydet — Makine adımı: bir sürümü yayında (öncekini geride) ya da başarısız olarak, adımlarıyla kaydeder.

Gereken izin site:manage · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/site.finish_deploy

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.deployed, site.deploy_failed

Neye yazar: site_deploy (update) — Live or failed; the previous live version becomes superseded

curl -X POST https://app.getera.io/api/v1/site_deploys/SITE_DEPLOY_ID/actions/finish_deploy \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"ok":true}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.deployed",
    "site.deploy_failed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.siteDeploys.finishDeploy("SITE_DEPLOY_ID", {
  ok: true
})

era site_deploys finish_deploy SITE_DEPLOY_ID \
  --ok true

{
  "name": "era__site__finish_deploy",
  "arguments": {
    "id": "SITE_DEPLOY_ID",
    "ok": true
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 deploy_not_found, not_uploading · 429 çok sık istek

site.import_theme

Import a code site’s theme — Registers the sections and settings a code site declares in era.theme.json, so the owner edits them in Era’s theme editor. Values the owner already changed are kept; new settings get their defaults.

Gereken izin site:manage · siler ya da geri alınamaz

• Asıl adres: POST /api/v1/actions/site.import_theme

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.theme_imported, site.content_changed

Neye yazar: site_code_theme (upsert) — The manifest, one per site, with a version counter; site_content (upsert) — One entry per setting; existing values are kept; site_content (delete) — Settings no longer declared, only with prune

curl -X POST https://app.getera.io/api/v1/site_code_themes/actions/import_theme \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"siteId":"SITE_ID","manifest":{}}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.theme_imported",
    "site.content_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.siteCodeThemes.importTheme({
  siteId: "SITE_ID",
  manifest: {}
})

era site_code_themes import_theme --data '{"siteId":"SITE_ID","manifest":{}}'

{
  "name": "era__site__import_theme",
  "arguments": {
    "siteId": "SITE_ID",
    "manifest": {}
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 site_not_found, invalid_theme, invalid_content · 429 çok sık istek

site.mark_submission

Mesajı işaretle — Okundu, yanıtlandı, arşivlendi veya spam.

Gereken izin site:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/site.mark_submission

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.submission_marked

Neye yazar: contact_submission (update) — Changes the message state

curl -X POST https://app.getera.io/api/v1/contact_submissions/CONTACT_SUBMISSION_ID/actions/mark_submission \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"status":"new"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.submission_marked"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.contactSubmissions.markSubmission("CONTACT_SUBMISSION_ID", {
  status: "new"
})

era contact_submissions mark_submission CONTACT_SUBMISSION_ID \
  --status "new"

{
  "name": "era__site__mark_submission",
  "arguments": {
    "id": "CONTACT_SUBMISSION_ID",
    "status": "new"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 submission_not_found, no_change · 429 çok sık istek

site.move_page

Sayfayı taşı — Bir sayfayı başka birinin altına koyar; döngüye giren her şeyi reddeder.

Gereken izin site:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/site.move_page

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.page_moved

Neye yazar: page (update) — Re-parents the page through tree_move

curl -X POST https://app.getera.io/api/v1/pages/PAGE_ID/actions/move_page \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"parentId":"PAGE_ID"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.page_moved"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.pages.movePage("PAGE_ID", {
  parentId: "PAGE_ID"
})

era pages move_page PAGE_ID \
  --parent-id "PAGE_ID"

{
  "name": "era__site__move_page",
  "arguments": {
    "id": "PAGE_ID",
    "parentId": "PAGE_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 page_not_found, parent_not_found, cannot_parent_to_self, would_create_cycle · 429 çok sık istek

site.move_page_block

Sayfa bölümünü taşı — Bir bölümü sayfasında yeni bir konuma taşır.

Gereken izin site:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/site.move_page_block

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.blocks_changed

Neye yazar: theme (update) — Reorders one block in config.pageBlocks

curl -X POST https://app.getera.io/api/v1/themes/THEME_ID/actions/move_page_block \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"pageId":"PAGE_ID","blockId":"Section","toIndex":1}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.blocks_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.themes.movePageBlock("THEME_ID", {
  pageId: "PAGE_ID",
  blockId: "Section",
  toIndex: 1
})

era themes move_page_block THEME_ID \
  --page-id "PAGE_ID" \
  --block-id "Section" \
  --to-index 1

{
  "name": "era__site__move_page_block",
  "arguments": {
    "themeId": "THEME_ID",
    "pageId": "PAGE_ID",
    "blockId": "Section",
    "toIndex": 1
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 theme_not_found, theme_is_published, archived, page_not_found, block_not_found, invalid_blocks, duplicate_block_id · 429 çok sık istek

site.move_section

Bölümü taşı — Bir bölümü sayfasında başka bir yere taşır (taslakta).

Gereken izin site:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/site.move_section

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: site.blocks_changed, site.theme_draft_created

Neye yazar: theme (update) — Changes one page of the site’s draft (a draft is forked from the live theme when there is none); theme_snapshot (insert) — Keeps an automatic checkpoint of the draft before the change; theme (insert) — Starts a draft when the site has none

curl -X POST https://app.getera.io/api/v1/theme_snapshots/actions/move_section \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"section":"Section"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "site.blocks_changed",
    "site.theme_draft_created"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.themeSnapshots.moveSection({
  section: "Section"
})

era theme_snapshots move_section \
  --section "Section"

{
  "name": "era__site__move_section",
  "arguments": {
    "section": "Section"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde site:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 site_not_found, page_not_found, block_not_found, no_position, nothing_to_change · 429 çok sık istek

site.publish

Siteyi yayına al — Bir dağıtım değil, bir anahtar — bir adres ona yönlendiği anda.

Gereken izin site:manage · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/site.publish

Girdi