# SendDrop REST-API: Überblick

Die **SendDrop REST-API** ist die ideale Lösung, wenn Sie:

* Ein **individuelles Shop-System** betreiben, für das es keine fertige Integration gibt.
* Ein **ERP** oder **WMS** direkt anbinden möchten (SAP, Odoo-Custom, Microsoft Dynamics, etc.).
* **Bulk-Imports** automatisieren wollen.
* **Eigene Dashboards** oder Reports aus den SendDrop-Daten bauen möchten.

***

### Was die API kann

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th></tr></thead><tbody><tr><td><strong>📦 Bestellungen</strong></td><td>Anlegen, aktualisieren, auflisten, stornieren.</td><td></td></tr><tr><td><strong>🏷 Labels</strong></td><td>Erzeugen, herunterladen (PDF), stornieren.</td><td></td></tr><tr><td><strong>📍 Tracking</strong></td><td>Status einzelner Sendungen abfragen oder per Webhook abonnieren.</td><td></td></tr><tr><td><strong>👥 Stammdaten</strong></td><td>Absenderadressen, Dropshipping-Partner, Artikel (sofern verwendet).</td><td></td></tr><tr><td><strong>🚚 Carrier &#x26; Tarife</strong></td><td>Verfügbare Carrier-Services und Tarif-Vorschau.</td><td></td></tr></tbody></table>

***

### Authentifizierung

Die API verwendet **Bearer-Token-Authentifizierung**:

```http
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx
```

Token werden in **Einstellungen → API / Schnittstelle** erzeugt und verwaltet. Siehe Artikel *API-Token erstellen & verwalten*.

***

### Basis-URL

```
https://api.senddrop.com/v1
```

Alle Endpoints sind über HTTPS erreichbar. HTTP wird nicht unterstützt.

***

### Beispiel-Request

Eine einfache Bestellung anlegen (gekürzt):

```http
POST /orders
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

{
  "externalOrderId": "ORDER-12345",
  "recipient": {
    "name": "Max Mustermann",
    "street": "Musterstraße 1",
    "zip": "1010",
    "city": "Wien",
    "country": "AT",
    "email": "max@example.com"
  },
  "parcels": [
    { "weightKg": 1.5 }
  ]
}
```

Antwort (gekürzt):

```json
{
  "id": "ord_abc123",
  "status": "CREATED",
  "trackingNumber": null,
  "createdAt": "2026-04-18T10:15:00Z"
}
```

***

### Versionierung

Alle Endpoints sind versioniert: aktuell `v1`. Breaking Changes werden nur in neue Major-Versionen eingeführt. Ältere Versionen unterstützen wir mindestens 12 Monate nach Veröffentlichung einer neuen Version.

***

### Rate Limits

| Tarif | Anfragen pro Minute |
| ----- | ------------------- |
| Plus  | 60                  |
| Pro   | 300                 |
| Ultra | 1000+ (auf Anfrage) |

Der **Free-Tarif** hat keinen API-Zugang.

Details siehe Artikel *Rate Limits & Fehlerbehandlung*.

***

### SDKs & Tools

Aktuell stellen wir offiziell bereit:

* **Postman-Collection** zum schnellen Ausprobieren.
* **OpenAPI 3.0-Spezifikation** (YAML/JSON) zur Code-Generierung.

SDKs in konkreten Sprachen sind in Arbeit. Bis dahin funktionieren generierte Clients aus der OpenAPI-Spec (z. B. `openapi-generator-cli`) zuverlässig.

***

### Weiterlesen

* **API-Token erstellen & verwalten**
* **Bestellung per API anlegen (Tutorial)**
* **Webhooks einrichten**
* **Rate Limits & Fehlerbehandlung**

***

### Support für API-Themen

Spezifische API-Fragen beantworten wir gerne unter <support@senddrop.com> mit dem Betreff **„API"**. Für Enterprise-Kunden steht zusätzlich ein dedizierter Integrations-Ansprechpartner zur Verfügung.

***

### Siehe auch

{% content-ref url="/pages/3s9tgw337yBnpQTomtoS" %}
[API-Token erstellen & verwalten](/10.-entwickler-and-integrationen/api-token.md)
{% endcontent-ref %}

{% content-ref url="/pages/5sTe03qmvK6RuszLseT4" %}
[Bestellung per API anlegen (Tutorial)](/10.-entwickler-and-integrationen/bestellung-per-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/X9wi0yFXdrZChdSB8tjl" %}
[Webhooks einrichten](/10.-entwickler-and-integrationen/webhooks.md)
{% endcontent-ref %}

{% content-ref url="/pages/YMo2pftej5EmimqvdIny" %}
[Rate Limits & Fehlerbehandlung](/10.-entwickler-and-integrationen/rate-limits-fehler.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.senddrop.com/10.-entwickler-and-integrationen/rest-api-ueberblick.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.