Zum Inhalt springen

Die öffentlichen Dokumente eines Vereins

GET
/v1/aps/{slug}/documents
curl --request GET \
--url https://api.vimine.network/v1/aps/example/documents

Die Dokumente, die der Verein in seiner Bibliothek öffentlich gemacht hat — eine Gründungsurkunde, ein früheres Statuto, weitere Akten — jedes mit Art, Titel, Datum und der Adresse seines Originals. Ein Protokoll oder die genehmigten Jahresabschlüsse sind hier nie zu finden. Nur lesbar; das geltende Statuto und das geltende Regolamento haben eigene Routen.

slug
erforderlich
string

Die öffentlichen Dokumente

Medientypapplication/json
object
aps
erforderlich
object
slug
erforderlich
string
name
erforderlich
string
documents
erforderlich
Array<object>
object
uid
erforderlich
string Format: uuid
kind
erforderlich

Founding_act · past_statute · other (ein Protokoll oder die Jahresabschlüsse sind nie öffentlich)

string
Erlaubte Werte: founding_act past_statute accounts minutes other
title
erforderlich
string
act_date

Das Datum des Akts

string Format: date
nullable
period

Das Geschäftsjahr der Jahresabschlüsse (2025, 2025/2026)

string
nullable
pages
integer
nullable
bytes
integer
nullable
content_type

Application/pdf, image/jpeg oder image/png

string
nullable
sha256

SHA-256 des Originals, wie es hochgeladen wurde

string
nullable
url
erforderlich

GET antwortet mit 302 auf einen fünfzehn Minuten gültigen Link zum Original — fragen Sie ihn bei Bedarf an, speichern Sie ihn nicht

string Format: uri
Beispiel
{
"documents": [
{
"kind": "founding_act"
}
]
}

Ungültige Anfrage

Medientypapplication/problem+json
object
type
erforderlich
string Format: uri
title
erforderlich
string
status
erforderlich
integer
detail
string
code
erforderlich
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Beispielerzeugt
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"request_id": "example",
"errors": [
{
"field": "example",
"code": "example",
"message": "example"
}
]
}

Unbekannter Verein, oder einer ohne öffentliche Präsenz

Ratenlimit überschritten

Medientypapplication/problem+json
object
type
erforderlich
string Format: uri
title
erforderlich
string
status
erforderlich
integer
detail
string
code
erforderlich
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Beispielerzeugt
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"request_id": "example",
"errors": [
{
"field": "example",
"code": "example",
"message": "example"
}
]
}

Interner Fehler

Medientypapplication/problem+json
object
type
erforderlich
string Format: uri
title
erforderlich
string
status
erforderlich
integer
detail
string
code
erforderlich
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Beispielerzeugt
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"request_id": "example",
"errors": [
{
"field": "example",
"code": "example",
"message": "example"
}
]
}