# API

## Integracja z API EmailLabs

EmailLabs udostępnia nowoczesne **REST API**, które umożliwia integrację zewnętrznych systemów z infrastrukturą EmailLabs. API zostało zaprojektowane zgodnie ze specyfikacją **JSONAPI**, co zapewnia jego czytelność i intuicyjność. Dokumentacja API jest generowana na podstawie pliku **Swagger** zgodnego ze standardem **OpenAPI 3.0.2.**

### Ogólne Zasady Działania API

* **Format komunikacji**: API obsługuje i zwraca dane wyłącznie w formacie JSON. Wszystkie żądania muszą być wysyłane z nagłówkiem Content-Type: application/json
* **Schemat odpowiedzi**: Wszystkie odpowiedzi zwracane przez API mają ujednoliconą strukturę:

```
{
	"meta": {
    	"numberOfErrors": 0,
    	"numberOfData": 1,
    	"status": 200,
    	"uniqId": "12345-abcde-67890",
    	"someField": "optional_value"
	},
	"data": [],
	"errors": [
    	{
        	"title": "Błąd",
        	"message": "Opis błędu",
        	"code": "ERROR_CODE",
        	"meta": {
            	"parameter": "nazwa_parametru",
            	"value": "wartość_parametru",
            	"source": "źródło_błędu"
        	}
    	}
	]
}

```

### Uwierzytelnianie w API

API EmailLabs wymaga uwierzytelnienia za pomocą dwóch kluczy:

* **Application-Key** – klucz aplikacji.
* **Authorization** – klucz autoryzacyjny (ciąg 128 znaków).

Klucze można wygenerować w panelu EmailLabs w sekcji **Konto -> Ustawienia -> API**.\
Więcej informacji o tym jak wygenerować klucze znajdziesz [tutaj](https://newpanel.docs.emaillabs.io/konto/ustawienia/api/generowanie-kluczy-api).

### Dokumentacja API 

[Szczegółowa dokumentacja API](https://vercom.gitbook.io/emaillabs-api-docs)


---

# 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://newpanel.docs.emaillabs.io/integracje/api.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.