Zum Hauptinhalt springen

Get all countries including disabled ones (Admin only)

GET 
/company/country/all

Gibt eine paginierte Liste ALLER Länder im System zurück, einschließlich solcher mit enabled: false oder deleted: true. Dieser Endpunkt ist für die administrative Verwaltung des Länderkatalogs vorgesehen.

Ziel​

Systemadministratoren vollständige Sichtbarkeit aller Länder für Verwaltungszwecke zu bieten, einschließlich der Möglichkeit, deaktivierte oder logisch gelöschte Datensätze einzusehen.

Anwendungsfälle​

  • Länderverwaltungsoberfläche im Administrationspanel
  • Überprüfung deaktivierter Länder vor deren Reaktivierung
  • Prüfung von Änderungen im Länderkatalog im Zeitverlauf
  • Wiederherstellung logisch gelöschter Länder

Authentifizierung​

Erforderlich: Administratorrolle (admin oder dev) Middleware: m.isAdmin

Unterschiede zum öffentlichen Endpunkt​

  • GET /company/country/: Gibt nur Länder mit enabled: true zurück (öffentlich)
  • GET /company/country/all: Gibt ALLE Länder inklusive deaktivierter zurück (nur Admin)

Beispielanfrage:

GET /company/country/all?page=1&limit=50
Authorization: Bearer {admin_jwt_token}

Beispielantwort:

{
  status: 200,
  data: {
    docs: [
      {code: es},
      {code: pt},
      {code: xx}
    ],
    totalDocs: 30,
    limit: 50,
    page: 1,
    totalPages: 1,
    pagingCounter: 1,
    hasPrevPage: false,
    hasNextPage: false,
    prevPage: null,
    nextPage: null
  }
}

Request​

Responses​

Erfolgreicher Eingriff

Response Headers