Changelog API Tutorial — Eintraege programmatisch erstellen

Was du lernen wirst

Dieses Tutorial zeigt dir, wie du die Deplyd REST API nutzt, um Changelog-Eintraege programmatisch zu erstellen und zu verwalten. Perfekt fuer CI/CD-Integration, eigene Admin-Tools oder Slack-Bots.

Authentifizierung

Jede API-Anfrage erfordert einen Bearer-Token. Erstelle einen API-Key in deinem Deplyd-Dashboard — er beginnt mit dpl_ und wird nur einmal angezeigt:

Authorization: Bearer dpl_your_api_key_here

Eintrag erstellen

curl -X POST https://deplyd.dev/api/v1/entries \
  -H "Authorization: Bearer dpl_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Dark mode support",
    "body": "The widget now automatically adapts to your site dark mode.",
    "type": "feature",
    "published": true
  }'

Eintraege auflisten

curl https://deplyd.dev/api/v1/entries?limit=10&page=1 \
  -H "Authorization: Bearer dpl_abc123"

Die Antwort enthaelt Paginierungs-Metadaten:

{
  "data": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "title": "Dark mode support",
      "body": "The widget now automatically adapts...",
      "type": "feature",
      "published": true,
      "published_at": "2026-04-01T10:00:00Z"
    }
  ],
  "meta": {
    "total": 42,
    "page": 1,
    "limit": 10
  }
}

Eintragstypen

CI/CD-Integration

Veroeffentliche automatisch Changelog-Eintraege, wenn du ein GitHub Release erstellst:

# .github/workflows/changelog.yml
name: Publish Changelog
on:
  release:
    types: [published]

jobs:
  changelog:
    runs-on: ubuntu-latest
    steps:
      - name: Publish to Deplyd
        run: |
          curl -X POST https://deplyd.dev/api/v1/entries \
            -H "Authorization: Bearer ${{ secrets.DEPLYD_API_KEY }}" \
            -H "Content-Type: application/json" \
            -d "{
              \"title\": \"${{ github.event.release.name }}\",
              \"body\": $(echo '${{ github.event.release.body }}' | jq -Rs .),
              \"type\": \"feature\",
              \"published\": true
            }"

Rate Limits

• Kostenloser Plan: 30 Anfragen pro Minute
• Bezahlplaene: 100 Anfragen pro Minute
• Widget-Endpunkt: 300 Anfragen pro Minute