Solarware API-Dokumentation
YAML herunterladen

Partner anzeigen

get /api/v1/partners/{id}

Sicherheit

ApiKeyAuth

Parameter

Name In Typ Details
id path integer Pflicht Ressourcen-ID

Antworten

200 Partner-Details

application/json

{
    "allOf": [
        {
            "title": "API envelope",
            "type": "object",
            "properties": {
                "success": {
                    "type": "boolean"
                },
                "message": {
                    "type": "string",
                    "nullable": true
                },
                "errors": {
                    "nullable": true
                },
                "meta": {
                    "type": "object",
                    "nullable": true,
                    "additionalProperties": true
                }
            }
        },
        {
            "type": "object",
            "properties": {
                "data": {
                    "title": "Partner",
                    "type": "object",
                    "description": "Partner in list/show/create/update responses.",
                    "required": [
                        "id",
                        "name"
                    ],
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "unique_number": {
                            "type": "string",
                            "nullable": true
                        },
                        "unique_number_display": {
                            "type": "string",
                            "nullable": true
                        },
                        "code": {
                            "type": "string",
                            "nullable": true
                        },
                        "name": {
                            "type": "string"
                        },
                        "notes": {
                            "type": "string",
                            "nullable": true
                        },
                        "created_at": {
                            "type": "string",
                            "format": "date-time",
                            "nullable": true
                        },
                        "updated_at": {
                            "type": "string",
                            "format": "date-time",
                            "nullable": true
                        },
                        "addresses": {
                            "type": "array",
                            "items": {
                                "title": "Address",
                                "type": "object",
                                "description": "Address in responses.\n",
                                "required": [
                                    "address_line_1",
                                    "is_primary"
                                ],
                                "properties": {
                                    "id": {
                                        "type": "integer",
                                        "nullable": true
                                    },
                                    "contacts_id": {
                                        "type": "integer",
                                        "nullable": true
                                    },
                                    "partners_id": {
                                        "type": "integer",
                                        "nullable": true
                                    },
                                    "label": {
                                        "type": "string",
                                        "nullable": true
                                    },
                                    "address_line_1": {
                                        "type": "string"
                                    },
                                    "address_line_2": {
                                        "type": "string",
                                        "nullable": true
                                    },
                                    "zip_code": {
                                        "type": "string",
                                        "nullable": true
                                    },
                                    "city": {
                                        "type": "string",
                                        "nullable": true
                                    },
                                    "district": {
                                        "type": "string",
                                        "nullable": true
                                    },
                                    "state": {
                                        "type": "string",
                                        "nullable": true
                                    },
                                    "is_primary": {
                                        "type": "boolean"
                                    },
                                    "country": {
                                        "oneOf": [
                                            {
                                                "title": "Country",
                                                "type": "object",
                                                "required": [
                                                    "id",
                                                    "name"
                                                ],
                                                "properties": {
                                                    "id": {
                                                        "type": "integer"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "iso2": {
                                                        "type": "string",
                                                        "nullable": true
                                                    },
                                                    "iso3": {
                                                        "type": "string",
                                                        "nullable": true
                                                    },
                                                    "numeric_code": {
                                                        "type": "string",
                                                        "nullable": true
                                                    },
                                                    "phone_code": {
                                                        "type": "string",
                                                        "nullable": true
                                                    },
                                                    "capital": {
                                                        "type": "string",
                                                        "nullable": true
                                                    },
                                                    "currency": {
                                                        "type": "string",
                                                        "nullable": true
                                                    },
                                                    "currency_symbol": {
                                                        "type": "string",
                                                        "nullable": true
                                                    },
                                                    "native": {
                                                        "type": "string",
                                                        "nullable": true
                                                    },
                                                    "region": {
                                                        "type": "string",
                                                        "nullable": true
                                                    },
                                                    "subregion": {
                                                        "type": "string",
                                                        "nullable": true
                                                    }
                                                }
                                            },
                                            {
                                                "type": "null"
                                            }
                                        ]
                                    }
                                }
                            }
                        },
                        "phones": {
                            "type": "array",
                            "items": {
                                "title": "Phone",
                                "type": "object",
                                "description": "Phone in responses.",
                                "required": [
                                    "number",
                                    "is_primary"
                                ],
                                "properties": {
                                    "id": {
                                        "type": "integer",
                                        "nullable": true
                                    },
                                    "contacts_id": {
                                        "type": "integer",
                                        "nullable": true
                                    },
                                    "partners_id": {
                                        "type": "integer",
                                        "nullable": true
                                    },
                                    "label": {
                                        "type": "string",
                                        "nullable": true
                                    },
                                    "country_code": {
                                        "type": "string",
                                        "nullable": true
                                    },
                                    "number": {
                                        "type": "string"
                                    },
                                    "extension": {
                                        "type": "string",
                                        "nullable": true
                                    },
                                    "e164_number": {
                                        "type": "string",
                                        "nullable": true
                                    },
                                    "is_primary": {
                                        "type": "boolean"
                                    }
                                }
                            }
                        },
                        "emails": {
                            "type": "array",
                            "items": {
                                "title": "Email",
                                "type": "object",
                                "description": "Email in responses.",
                                "required": [
                                    "email",
                                    "is_primary"
                                ],
                                "properties": {
                                    "id": {
                                        "type": "integer",
                                        "nullable": true
                                    },
                                    "contacts_id": {
                                        "type": "integer",
                                        "nullable": true
                                    },
                                    "partners_id": {
                                        "type": "integer",
                                        "nullable": true
                                    },
                                    "label": {
                                        "type": "string",
                                        "nullable": true
                                    },
                                    "email": {
                                        "type": "string",
                                        "format": "email"
                                    },
                                    "is_primary": {
                                        "type": "boolean"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    ]
}
401 Missing or invalid API key

application/json

{
    "type": "object",
    "properties": {
        "success": {
            "type": "boolean",
            "example": false
        },
        "message": {
            "type": "string",
            "example": "Missing API key (X-Api-Key)"
        }
    }
}
404 Resource not found

application/json

{
    "title": "API envelope",
    "type": "object",
    "properties": {
        "success": {
            "type": "boolean"
        },
        "message": {
            "type": "string",
            "nullable": true
        },
        "errors": {
            "nullable": true
        },
        "meta": {
            "type": "object",
            "nullable": true,
            "additionalProperties": true
        }
    }
}