PT EN

Conectores

URL base: $PUBLIC_API

O objecto

keystring · obrigatório

Stable connector key

kindstring · obrigatório

Connector kind, for example payment, messaging or meter

namestring · obrigatório

Display name

descriptionstring · obrigatório

Short description for an integrations directory

markstring · opcional

URL path of the connector's mark image; omitted when it has none

capabilitiesarray of string · obrigatório

What the connector supports

O objecto
{
  "key": "key",
  "kind": "active",
  "name": "Ana Matsinhe",
  "description": "Leitura confirmada no local.",
  "mark": "mark",
  "capabilities": [
    "capabilitie"
  ]
}

Listar conectores activos

Registos

GET /connectors

Lists the connectors this installation has enabled (for example payment, messaging and meter connectors), for an integrations directory. Each entry is the connector's public descriptor: key, kind, display name, description and capabilities, plus a mark URL when the connector has a mark image. Connectors are registered at runtime, so the list differs between installations; disabled and development-only connectors are left out. Sorted by kind, then key. No sign-in is needed; responses may be cached for 5 minutes.

Devolve

200 Enabled connectors

Mostrar atributos
dataarray of PublicConnector · obrigatório

Enabled connectors sorted by kind

Mostrar atributos filhos
keystring · obrigatório

Stable connector key

kindstring · obrigatório

Connector kind, for example payment, messaging or meter

namestring · obrigatório

Display name

descriptionstring · obrigatório

Short description for an integrations directory

markstring · opcional

URL path of the connector's mark image; omitted when it has none

capabilitiesarray of string · obrigatório

What the connector supports

curl -X GET "$PUBLIC_API/connectors"
Resposta 200
{
  "data": [
    {
      "key": "key",
      "kind": "active",
      "name": "Ana Matsinhe",
      "description": "Leitura confirmada no local.",
      "mark": "mark",
      "capabilities": [
        "capabilitie"
      ]
    }
  ]
}

Obter o logótipo de um conector

Registos

GET /connectors/{key}/mark

Returns the raw mark image registered for a connector, with the content type it was registered with (for example image/svg+xml or image/png). Use the mark URL from the connector list rather than building it. A key with no registered mark returns 404. No sign-in is needed; responses may be cached for 5 minutes.

Parâmetros

keystring · caminho · obrigatório

Connector key as returned by the connector list (case-insensitive).

Devolve

200 Mark image bytes

Erros 404

curl -X GET "$PUBLIC_API/connectors/{key}/mark"
Resposta 200

Mark image bytes