deeplcom / openapi Goto Github PK

View Code? Open in Web Editor NEW

60.0 60.0 29.0 416 KB

OpenAPI specification of the DeepL API

License: MIT License

Python 100.00%

openapi's People

Contributors

Stargazers

Watchers

openapi's Issues

A little advice from a foreign friend

You can check out the translation model of this plugin, it would be simply awesome if the officials would collaborate with them or make a similar plugin
His translation is based on the original with annotations
https://twitter.com/immersivetran
https://microsoftedge.microsoft.com/addons/detail/%E6%B2%89%E6%B5%B8%E5%BC%8F%E7%BF%BB%E8%AF%91/amkbmndfnliijdhojkpoglbnaaahippg

This translation model is great for students who are learning a foreign language!

API for Write

Is it possible to have API for https://www.deepl.com/write

Generation with openapi-generator fails

I am failing with generating with this maven plugin

            <!-- https://mvnrepository.com/artifact/org.openapitools/openapi-generator-maven-plugin -->
            <plugin>
               <groupId>org.openapitools</groupId>
               <artifactId>openapi-generator-maven-plugin</artifactId>
               <version>7.0.1</version>
               <executions>
                  <execution>
                     <goals>
                        <goal>generate</goal>
                     </goals>
                     <configuration>
                        <inputSpec>https://raw.githubusercontent.com/DeepLcom/openapi/main/openapi.yaml</inputSpec>
                        <apiPackage>com.example.deepl.generated.api</apiPackage>
                        <modelPackage>com.example.deepl.generated.api.model</modelPackage>
                        <generatorName>java</generatorName>
                        <library>resttemplate</library>
                        <useSpringBoot3>true</useSpringBoot3>
                        <skipValidateSpec>true</skipValidateSpec>
                        <generateApis>true</generateApis>
                        <generateModels>true</generateModels>
                        <generateSupportingFiles>true</generateSupportingFiles>
                        <generateClientAsBean>true</generateClientAsBean>
                        <legacyDiscriminatorBehavior>false</legacyDiscriminatorBehavior>
                        <generateApiTests>true</generateApiTests>
                        <generateModelTests>true</generateModelTests>
                        <generateApiDocumentation>true</generateApiDocumentation>
                        <generateModelDocumentation>true</generateModelDocumentation>
                        <configOptions>
                           <delegatePattern>true</delegatePattern>
                           <additionalModelTypeAnnotations>@lombok.Data; @edu.umd.cs.findbugs.annotations.SuppressFBWarnings</additionalModelTypeAnnotations>
                          <additionalEnumTypeAnnotations>@edu.umd.cs.findbugs.annotations.SuppressFBWarnings</additionalEnumTypeAnnotations>
                           <additionalOneOfTypeAnnotations>@edu.umd.cs.findbugs.annotations.SuppressFBWarnings</additionalOneOfTypeAnnotations>
                        </configOptions>

                        <configHelp>false</configHelp>
                     </configuration>
                  </execution>
               </executions>
            </plugin>

TranslateTextApi is getting generated with

import com.example.deepl.generated.api.model.TranslateTextRequest;
import com.example.deepl.generated.api.model.TranslateTextRequest1;

But the TranslateTextRequest1 is not getting generated at all so that my generated code is

TranslateTextRequest1 cannot be resolved

Adding the openai.json to actions in GPTs

I tried to add openai.json and openai.yaml to actions in GPTs. However, several errors occurred in both files.
In total, two types error messages are found.
The first is

In context=('components', 'schemas', 'NonSplittingTagCommaSeparatedList', 'allOf', '0'), reference to unknown component TagCommaSeparatedList; using empty schema

I have fixed this type of error by changing

"allOF": [
{
    "$ref": "#/components/schemas/TagCommaSeparatedList"
  }
]

"items": {
            "$ref": "#/components/schemas/TagCommaSeparatedList"
          },

However, I can't solve the second type of problem:

In path /document/{document_id}, method post, operationId getDocumentStatus, parameter {'$ref': '#/components/parameters/DocumentID'} is has missing or non-string name; skipping
In path /document/{document_id}, method post, operationId getDocumentStatus, skipping function due to errors
In path /glossaries/{glossary_id}, method get, operationId getGlossary, parameter {'$ref': '#/components/parameters/GlossaryID'} is has missing or non-string name; skipping
In path /glossaries/{glossary_id}, method get, operationId getGlossary, skipping function due to errors

Everything looks fine to me, I don't know why is this error occurring. I have already tried changing name "document_id" to "DocumentID".
Can any one help me on this?

Hey, I think I spotted a mistake in the specification. I'm new to the OpenAPI but if I understand it correctly, the specification currently says the detected_source_language conforms to two types: SourceLanguage and a type with only a description (line 205) and thus any content(?).

openapi/openapi.json

Lines 199 to 208 in 7067183

    
           "detected_source_language": { 
        
             "allOf": [ 
        
               { 
        
                 "$ref": "#/components/schemas/SourceLanguage" 
        
               }, 
        
               { 
        
                 "description": "The language detected in the source text. It reflects the value of the `source_lang` parameter, when specified." 
        
               } 
        
             ] 
        
           },

I believe the section instead should be:

"detected_source_language": {
    "allOf": [
      {
        "$ref": "#/components/schemas/SourceLanguage"
      }
    ],
    "description": "The language detected in the source text. It reflects the value of the `source_lang` parameter, when specified."
  },

I'm not sure if the yaml file also needs to be fixed.

deeplcom / openapi Goto Github PK

openapi's People

Contributors

Stargazers

Watchers

Forkers

openapi's Issues

A little advice from a foreign friend

говно

API for Write

Generation with openapi-generator fails

/

Adding the openai.json to actions in GPTs

Mistake in specification

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent

	"detected_source_language": {
	"allOf": [
	{
	"$ref": "#/components/schemas/SourceLanguage"
	},
	{
	"description": "The language detected in the source text. It reflects the value of the `source_lang` parameter, when specified."
	}
	]
	},