nostr/nips
1
0
Fork 0
mirror of https://github.com/nostr-protocol/nips.git synced 2024-12-22 16:35:52 -05:00
Code Issues Actions Packages Projects Releases Wiki Activity

added Austin

Browse Source
This commit is contained in:
Coach Chuck 2023-09-13 07:51:06 -06:00
parent b6f3e249cd
commit dbd1b9f586
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
105.md
View File

@ -4,7 +4,7 @@ NIP-105
API Service Marketplace API Service Marketplace
------------------------------- -------------------------------
`draft` `optional` `author:coachchuckff` `author:unclejim21` `author:cmdruid` `draft` `optional` `author:coachchuckff` `author:unclejim21` `author:cmdruid` `author:austinkelsay`
This NIP defines `kind:31402` (a _parameterized replaceable event_) for broadcasting API services, endpoints and their costs in mSats. API services are offered ala carte to be paid via lightning invoices. This NIP defines `kind:31402` (a _parameterized replaceable event_) for broadcasting API services, endpoints and their costs in mSats. API services are offered ala carte to be paid via lightning invoices.
@ -22,7 +22,7 @@ API service providers will issue a `kind:31402` event as an API service offering
## Server Functions ## Server Functions
### Create Invoice ### Create Invoice
Initally, the client will make a POST request to the `endpoint`. The POST body should be exactly what the underlying API is expecting less the API key. This information should also be represented in the `schema` portion of the `content` field. Initially, the client will make a POST request to the `endpoint`. The POST body should be exactly what the underlying API is expecting less the API key. This information should also be represented in the `schema` portion of the `content` field.
The service provider will then do the following: The service provider will then do the following:
@ -69,8 +69,8 @@ It is up to the Client to poll the `successAction` until a terminal result is re
endpoint: string, // The POST endpoint you call to pay/fetch endpoint: string, // The POST endpoint you call to pay/fetch
status: OfferingStatus, // UP/DOWN/CLOSED status: OfferingStatus, // UP/DOWN/CLOSED
cost: number, // The cost per call in mSats cost: number, // The cost per call in mSats
schema?: Object, // Reccomended - JSON schema for the POST body of the endpoint schema?: Object, // Recommended - JSON schema for the POST body of the endpoint
outputSchema?: Object, // Reccomended - JSON schema for the response of the call outputSchema?: Object, // Recommended - JSON schema for the response of the call
description?: string // Optional - Description for the end user description?: string // Optional - Description for the end user
} }
``` ```
@ -208,7 +208,7 @@ The following is for the `gpt-3.5-turbo` output schema:
} }
} }
``` ```
### Safey ### Safety
It is not mandatory, but to raise the barrier to entry, clients should screen service provider's NIP-05 identifier. The domain used in their NIP-05, should be the same domain used for their endpoint. It is not mandatory, but to raise the barrier to entry, clients should screen service provider's NIP-05 identifier. The domain used in their NIP-05, should be the same domain used for their endpoint.
@ -218,7 +218,7 @@ Clients may wish to create a whitelist of trusted service providers once tested.
- No data integrity - service providers can store/redistribute any data passed to them - No data integrity - service providers can store/redistribute any data passed to them
- Service providers could take payment and never return the product - Service providers could take payment and never return the product
- Service providers are not gaurenteed to call the endpoint specified in the `s` tag - Service providers are not guaranteed to call the endpoint specified in the `s` tag
- No recourse for errored API fetches - No recourse for errored API fetches
- The `cost` field may not match the actual final price - The `cost` field may not match the actual final price
- No proof of purchase - No proof of purchase