Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
version: 1.0.0
title: Pet Adoption Manage API
description: A pet adoption API.
contact:
name: John Doe
url: https://example.com/john-doe
email: john.doe@example.com
servers:
- url: https://api.fortellis.io/data/v1/example/pet-adoption
security:
- permission-model:
- anonymous
tags:
- name: manage
paths:
/pets:
post:
summary: Adds a pet to the store
description: Adds a pet to the store
operationId: addPet
tags:
- manage
parameters:
- $ref: '#/components/parameters/header.Request-Id'
- $ref: '#/components/parameters/header.Subscription-Id'
- $ref: '#/components/parameters/header.Authorization'
- $ref: '#/components/parameters/body.AddUpdatePet'
responses:
'200':
$ref: '#/components/responses/Pet'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'503':
$ref: '#/components/responses/ServiceUnavailable'
components:
responses:
BadRequest:
description: 400 - Bad Request
headers:
Request-Id:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Forbidden:
description: 403 - Forbidden
headers:
Request-Id:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Unauthorized:
description: 401 - Unauthorized
headers:
Request-Id:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Pet:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/Pet'
ServiceUnavailable:
description: 503 - Service Unavailable
headers:
Request-Id:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
parameters:
header.Subscription-Id:
name: Subscription-Id
in: header
required: true
description: The Fortellis Marketplace subscription identifier between a user entity and the solution. For sample responses use the Subscription-Id 'test'.
schema:
type: string
format: guid
header.Request-Id:
name: Request-Id
in: header
required: true
description: "A correlation ID that should be returned back to the caller to \nindicate the return of the given request\n"
schema:
type: string
format: uuid
body.AddUpdatePet:
name: AddPet
in: body
required: true
schema:
$ref: '#/components/schemas/AddUpdatePet'
description: A request body to add or update a pet.
header.Authorization:
name: Authorization
in: header
description: "Contains credentials that allows the caller to authenticate itself with the \nAPI. See RFC 7235 and RFC 7617 for more details.\n"
schema:
type: string
schemas:
ErrorResponse:
description: Common error response object.
properties:
code:
type: integer
format: int32
message:
type: string
required:
- code
- message
example:
code: 400
message: Bad Request
Pet:
description: A pet record
properties:
petId:
type: string
description: The record identifier of the pet
name:
type: string
description: The name of the pet
type:
type: string
enum:
- dog
- cat
description: The type of pet
required:
- petId
- name
- type
example:
petId: ABC123
name: Fido
type: dog
AddUpdatePet:
description: The payload to create or update a pet's adoption record
properties:
name:
type: string
description: The name of the pet
type:
type: string
enum:
- dog
- cat
description: The type of pet
required:
- name
example:
name: Fido
type: dog
securitySchemes:
permission-model:
type: oauth2
flows:
implicit:
scopes:
pets.adopt: permission to query, read, and adopt pets
pets.manage: permission to add, modify, and remove pets
authorizationUrl: https://identity.fortellis.io/oauth2/